Troubleshooting

Start with the symptom you see. Most problems come from the domain, from code that was edited after copying it, or from a setting your plan does not include.

The widget does not appear

Check these in order:

1. The code is complete. Paid plans need both the <script> line and the <ls-soccersapi> tag. Free needs the whole <iframe> line. Copy it again from Get code if in doubt.
2. The page runs on an approved domain. Open Domains. example.com covers www.example.com and every other subdomain, but scores.example.com does not cover example.com.
3. Your site builder keeps the code. Some builders remove <script> tags, or run pasted code in a frame of their own. See where to paste it.
4. The code has not been changed by hand. uid and widget-id must stay exactly as Get code wrote them.

If the widget shows a message instead, look for it below.

"Domain unauthorized"

The widget is running on a domain that is not approved for your account. The message names the domain it saw.

• Add that domain in Domains. The widget can use it on the next page load.
• If the named domain is not yours (for example a site builder's own address), your builder runs the code in a frame on another domain. Contact support with that address.
• After a downgrade, only as many domains as the new plan allows keep working: the most recently updated ones.

"Domain blocked"

SoccersAPI has blocked the widget on that domain. Only support can change it: write to [email protected].

"Free Widgets V2 must be embedded with the SoccersAPI iframe"

A Free account is using the script installation of paid plans. Use the iframe code from Get code, or upgrade to Starter or above.

"An active subscription is required to use this widget"

The code asks for something your plan does not include: usually a Match, League, Team, Player or Leagues widget on Free or Starter, or any widget after a paid subscription ended. Check your plan in Widgets › Plans.

"This widget has reached the monthly traffic allowance"

The Free plan pauses at 25,000 views a month. The widget comes back on the first day of the next month (UTC), or as soon as you upgrade. Paid plans are never paused. See Traffic.

"Widget not found"

The account in the code has no configuration for this widget. Usually uid or widget-id was edited, or the code comes from another account. Copy fresh code from Get code.

"Token not found"

This message usually hides another problem:

• On Free, the monthly allowance of 25,000 views may be used up. Check Widgets › Traffic in the admin.
• The uid in the code may have been changed. Copy fresh code from Get code.

The widget looks unstyled

The widget loads, but without its colours and fonts.

• Keep data-ls-widgets="umd" and data-ls-widgets-style on the script line: the widget uses them to find its stylesheet.
• If your site has a Content Security Policy, allow the hosts listed in the embed code reference.
• A <style> or <link> element with id="styles" on your page stops the widget from loading its own stylesheet. Rename that id.

My changes do not show on my site

• Did you save? The status at the top of the editor must read Configuration saved. There is no other publish step.
• Is it the right configuration? In Domains, check which configuration the domain loads. If you edited another one, assign it with Apply to.
• Wait and reload. Saved changes reach visitors within about 30 seconds, on their next page load.
• Is your page cached? A caching plugin or CDN can keep serving an old version of your page. The widget itself loads its configuration each time.

A setting has no effect

• It is locked by your plan. Locked settings keep their value in the editor, but the widget ignores them. They are listed under Not in your plan.
• It was removed when you saved. Saving the default configuration on a plan without a feature removes that feature's settings (for example your logo on Free). Set them again after upgrading.
• It is still being rolled out. Featured leagues on Free and where-to-watch links on Pro are not active yet; see Plans and limits.
• It depends on another setting. Many settings only appear or apply when another one is on. The configurator options page says which.

A Match, League, Team or Player widget shows the wrong item

The code still has the sample number from the preview. Change matchid, leagueid, teamid or playerid in the code to your item's number, or type it in the configurator before copying the code.

Clicks do not open what I chose

• On Free and Starter, every click opens the modal. Choosing another navigation mode needs Pro or Ultra.
• Floating cards: a type that is unticked under Open as floating card opens in the modal. Under 900 px, pinned items sit in a tray at the bottom of the widget instead of cards.
• Nothing happens at all: the navigation mode is None (no entity links).
• Dynamic Pages: see the Dynamic Pages checks.

Odds do not show

• Bookmaker odds enabled or Inline odds in match row is off, or your plan does not include odds (Pro and Ultra).
• The visitor turned odds off with the Odds switch in the toolbar.
• Compliance hides them: Clean mode, a restricted country, or an unknown country under a country policy.
• The bookmaker has no odds for that match. Odds are only shown in the livescore rows, the match header and the Odds tab, never in fixture lists.

Affiliate links do not show

• Affiliate links enabled is off, or Show in match rows / Show in match header is off.
• The link's own Enabled is off, or its URL is empty.
• The link is above your plan's limit (Pro 5, Ultra 20).
• Compliance hides affiliate links for this visitor, or the link's Target countries, Restricted countries or Restricted devices exclude them.

Banners or bookmaker logos do not show

Check the banner slot's Enabled and Image URL, that your plan includes that slot (top and bottom slots are unlocked separately), and the compliance switches Disable commercial banners and Hide bookmaker logos.

A live match shows no minute

The minute comes from the data feed. Some competitions do not send it, and just after kick-off it can take a moment to appear. Half-time shows HT instead of a minute.

The layout looks cramped

• Set the configurator preview to the real width of your column and check it there.
• Choose Density: Compact in the Basic view, or turn on Compact mode.
• Give the widget a container at least 320 px wide.

Dark mode or language is not the one I set

• Theme. The widget does not follow your site's own dark mode. It uses, in this order: the theme attribute on the tag, the visitor's own choice (the theme icon in the toolbar), the configuration's default, and light. Use theme="system" to follow the visitor's device setting.
• Language. A language the visitor picked in the widget's settings is remembered and wins over the locale in your code and the configuration.

See the embed code reference.

Still stuck?

Write to [email protected] with:

• the address of the page where the widget should appear;
• the domain and the configuration name from the admin;
• a screenshot, and the exact message if there is one;
• your browser and device.

Never send passwords, API keys or payment details.