Troubleshooting
Common widget errors and what to check first.
widget_not_found
Most common cause
The widget code was copied before the configuration was published, or the code belongs to a different widget owner.
domain_unauthorized
Add the exact domain in the admin and save the configuration.
For the Free iframe, approve the website where the iframe is placed. For native embed delivery, approve the website page where the widget appears.
Blank iframe
Check that the code was copied after publishing the configuration and that the
iframe URL still includes the correct uid, widget-id and locale.
If the iframe is still blank after copying fresh code, contact SoccersAPI
support with the page URL and the widget uid.
Native embed blocked on Free
Free widgets are iframe-only. Use Starter, Pro, Ultra or Custom for paid native Web Component delivery.
Configurator differs from production
Different domains need different designs
Widgets V2 domains can load different saved configurations. Use the Loads
column in the Domains area to choose which configuration each domain should use.
If two approved domains use the same uid and widget-id, they can share the
default/current configuration or each load a different saved setup.
Iframe too short
The Free iframe code generated by the configurator uses 1200px by default.
If your page uses a shorter CSS height, the match list or match detail modal can
feel cut off.
Keep these values aligned:
- the
heightquery parameter - the
heightstyle value - the
min-heightstyle value