SoccersAPI Widgets V2

Troubleshooting

Common runtime errors and how to diagnose them.

widget_not_found

Check that:

  • the configuration was saved
  • the uid is correct
  • the widget-id is correct
  • the widget belongs to an active product/configuration

domain_unauthorized

Add the exact domain in the admin and save the configuration. For iframe delivery, the runtime checks the parent domain. For native delivery, it checks the host where the web component is running.

Blank iframe or $1 is not defined

This usually means the embed host is serving an outdated or malformed free.html. Redeploy the latest file and verify it does not contain literal replacement artifacts.

Native widget blocked on Free

Free widgets are iframe-only. Use Starter, Pro, Ultra or Custom for native web component delivery.

Configurator differs from production

Verify that both environments use the same saved configuration and the same static widget assets. Stale free.html, style.css or ls-soccersapi.umd.js can cause different headers, modal spacing or feature behavior.

On this page