What's new
Changes to Widgets V2 that you can see in your widget or in the configurator, newest first.
Changes reach every widget automatically: you never need new installation code for them. Dates are in UTC.
5 October 2026
New
-
Free widgets can show odds from SoccersAPI's own bookmaker catalogue, once SoccersAPI enables it: in the livescore match rows and in the header of the match window, with SoccersAPI's bookmakers, order and partner links, and the countries and devices it chooses for each one. The short line next to the odds starts with Ad. On Free, only a compliance policy enforced by your contract with SoccersAPI applies to them. The configurator has no setting to change or hide these odds, and the odds settings you saved are not used; the Odds tab stays Pro and Ultra. Until SoccersAPI enables a bookmaker, a Free widget shows no odds, as before. See Monetization.
-
SoccersAPI's partner buttons and odds on Free are not blocked by country. They follow the countries and devices SoccersAPI chooses for each bookmaker and partner link, and a compliance policy enforced by your contract. When the visitor's country cannot be detected, the items without a country list still appear. Where no notice text applies (the United States and Turkey), the short line next to them says Ad alone. SoccersAPI's banners are not affected.
-
Offers are complete in your SoccersAPI account. The configurator in the admin now has what the public playground had: Button, Text link and CTA banner offers, the inline places (match rows, match header and window, below the odds, floating card), rotation and the Match window, Prematch tab card. See Your own offers.
-
Your affiliate links move into Offers in the admin. The first time you open a configuration with affiliate links, the configurator turns them into Button (or Text link) offers with the same links, places, countries, devices and weights, and says so at the top of Offers. Your widget looks the same; when you save, they are stored as offers. Pro affiliate links and Bet link placement are no longer in the configurator. See Your affiliate links are offers.
-
The Ticker widget in the admin. From Starter, choose Ticker under Widget: Get code gives you its tag, with
entity="ticker". See The Ticker widget. -
The live ticker is a score bar of matches, like the one at the top of a sports site: each match shows its competition's logo and its status, then each team's crest, name or code and score, with a triangle next to the winner and the shoot-out or aggregate score when the data has them. Thin dividers separate the matches (Separate cards is still an option). It shows matches only: no Goal or Red labels; a changed score flashes for a few seconds. See Ticker and events log.
-
The ticker can move on its own: Motion is Continuous (a seamless loop, at the speed you choose), One match at a time or A full strip at a time (every 2 to 30 seconds). It stops under the pointer or the keyboard focus and in background tabs, has a pause button, and never moves for visitors who ask for reduced motion. Slides take the new Movement duration (Colors & surfaces, under Motion). See Motion.
-
Choose each event of the events log: one box per event (goals, red and yellow cards, missed penalties, kick-off, half-time, full-time, postponed matches), like the match sounds, for example goals only. New goals, red cards and postponements are read out to screen readers only if you tick them. See Events log.
-
The Ticker widget can start with a competition menu and a day menu, and end with a Results link to your results page.
Changed
-
Offer limits include your affiliate links in the admin too: 15 offers on Pro and 70 on Ultra (they were 10 and 50). The plan details in the admin list Offers, affiliate links included, instead of Affiliate links. See Plans and limits.
-
In the admin, only placements switched on count towards the placements of your plan (4 on Pro). When they are all on, a new placement is added switched off; before, a placement you had switched off counted too.
-
Your odds are marked as paid links. On Pro and Ultra, the odds in the match rows and in the match header that link to your bookmaker now carry
rel="sponsored noopener", as your offers already do, plusnoreferreras before. They get no Ad label.nofollowis added only if your link already asks for it. -
The widget's HTML uses its own class names. Its elements now carry
ls-*names that say what they are (ls-match-row__team-name,ls-league-row__title,ls-cal-day…) instead of generic utility classes such astruncate,flexorrounded-full. It looks exactly the same. If your stylesheet targeted one of those utility classes inside the widget, move the rule to the widget's own class names, listed with the ones you can rely on in CSS classes. -
Team names in stacked match rows (Default and Compact layouts) carry the
ls-match-row__team-nameclass, with--winner,--loseror--draw, for your stylesheet to target. Their size, weight and color stay in the element'sstyleattribute, so the CSS of your page cannot change them by accident: to restyle them, use!important(see CSS classes). In every layout, team names also carrydata-ls-team-name="home"or"away". -
The match header's older
ls-mh-*class names keep working; the CSS classes page lists the names to use in new CSS. -
The window grows and shrinks. The window's expand button now makes it grow quickly to full screen (or to the widget) and shrink back to its normal size, instead of jumping. When the visitor's device asks for reduced motion, it still changes size at once. See Expand the window.
-
A live ticker saved with "Latest events" shows the bar of matches. The events are in the events log, which can sit as a strip above or below the list. A Ticker widget saved with Auto-scroll moves one match every 4.5 seconds, and one saved without Competition labels shows no competition.
Fixed
- The live ticker follows your template's card colours. Its match cards, their borders and the bar behind them used fixed colours of their own, a navy blue in dark themes (next to Kickoff's grey rows, for example). They now take your template's match-row or card colour, its card border and the widget's background, in the livescore and in the Ticker widget. Ticker colours you set yourself stay as they are.
4 October 2026
New
- One header everywhere. Match, team, competition and player pages now use the same header as the window and the floating cards, with the tabs in one piece and the same colours. On a page it adds a back button in its first row and a second line of details (kick-off date, stadium, referee and attendance; foundation year and competitions; stage; weight, value and date of birth). See Match, team, competition and player pages.
- Frame in Match header and Entity header now sets how the header and its tabs sit on a page: edge to edge, or one card with or without a border. The old Frame's other job, flat or carded sections, is now called Sections. Saved designs look as before.
- Sticky header on a page now pins a compact row (status, teams, score and star) instead of the whole header. Layout: Minimal gives a compact header, Centered puts the crests above the names, and Score display: Solid boxes the score, on pages and in the window.
- Expand the window. With advanced navigation, the window that opens over the widget has a button between Minimize and close that makes it fill the screen, or the visible part of the widget, and back. Set it in Expand button. See Expand the window.
- Search in list starts on in new configurations. A configuration you start now (in the playground, and in the SoccersAPI admin in a later update) has Search in list in the Livescore toolbar. Configurations saved before keep it off, also when you save them again. See Search in the list.
Changed
-
Search in list moves into the row of tabs. The field no longer adds a third row under the toolbar: the toolbar is as tall as without it. When the row of tabs has room, typically on a wide widget whose tabs have a row of their own, the field sits at the end of the tabs and says which tab it searches (Search in Today). Elsewhere it is an icon at the end of the tabs that opens the field over them, with the open tab in front so visitors can switch tab without closing it; when they leave, the search stays as a chip and the tabs come back. See Search in the list.
-
The search icon is back with Search in list on: it opens the search for any team, competition or player, a different tool from narrowing the list.
-
Country and League are now one Filters button with a single list of countries and competitions. See The Filters button.
-
With Floating cards, a Leagues column set to Right shows on the left (on the right in Arabic and Persian), where the cards cannot cover it. The setting keeps Right and uses it again with any other navigation mode; the configurator explains it under Leagues column. See Leagues column.
-
In the match window, the short responsible-gambling notice (and Ad) under the header now lines up with the offer button it labels: at the end when the button is at the end of the header, centred or at the start when you place it there, and with the odds when there is no button.
-
The match window's header now says how a tie was decided, under the score: after extra time, the aggregate and the penalty shoot-out (for example "a.e.t. · Pens 4–5"), as the match page always did. With Score display: Solid the side that won the shoot-out is the filled one.
-
"Centered profile" for team, competition and player headers shows as Standard. The match header's competition label colour, radius and padding, the losing score colour and the entity header separator colour no longer apply.
-
If your site reads the match header from the page (for its own title or meta tags): the old class names (
ls-mh-name,ls-mh-league,ls-mh-status,ls-mh-score-num,ls-mh-datetime) stay on the new header for this release only. Read thedata-ls-team-name,data-ls-scoreanddata-ls-kickoffattributes instead.
3 October 2026
New
- Affiliate links are offers. Your affiliate links show as Button offers: quiet in the match rows (they look like the odds: logo, brand and a short label), in your brand colour in the match header, the match window and floating cards. Each match keeps one brand for the visit, the same in its row, its header and its window. See Your affiliate links are offers.
- Three new kinds of offer: CTA banner (a wide banner on your brand colour, above the matches or in a banner zone), Button and Text link (a sentence with your brand linked, below the odds). Add offer asks what you are adding, and Where it shows puts one offer in several places. See Kinds of offer and Inline places. First in the public playground; in the SoccersAPI admin since 5 October.
- Short notice next to odds. The responsible-gambling notice now also appears as one line above the first competition of the list and under the odds or betting link in the match header and the match window (and under the odds row of floating cards), wherever odds or betting links are shown. Before, it was only under the widget, after the whole list, where most visitors never scrolled. It is on by default and follows Show compliance notice; turn it off in Compliance. See Betting content and responsible gambling.
- When the rows show offer buttons, the short responsible-gambling line above the first competition starts with Ad. Where there is no notice to show, the line shows Ad alone.
- Odds position places the odds, and the Position in the header of an offer its button, on the left, in the center or on the right of the match header and the match window's header. See Bookmaker odds and Inline places.
- The affiliate link Color is now a colour picker with opacity and shortcuts to your theme colours. Values saved earlier keep working.
- Rotate offers (first in the public playground; in the configurator of your account since 5 October). An offer card, an offer strip and the pinned bar of a list can step through your offers every 4 to 30 seconds: the next one slides up over the current one. Off by default. See Rotate offers.
- +N on the offer strip. A strip with more than one offer opens the others as a list. See The strip and +N.
- Offer card in the Prematch tab of the match window, under Best odds (first in the public playground; in the configurator of your account since 5 October).
- Two new banner slots in the match list: Above the matches and In-feed (between leagues), after the competition you choose and optionally repeated. See Banners.
- Search in list adds a search field under the Livescore toolbar that narrows the day's matches by team, competition or country as visitors type, ignoring accents, with the matches highlighted and the tab counters counting what remains. Every plan. See Filters and leagues column.
- Country filter and League filter add two menus next to it, with only what plays in the open tab. Starter and up.
- Leagues column puts the competitions beside the matches, on the left or on the right. By feed filters the matches; Full list opens each competition the way your navigation mode says. Under 900 px it becomes a Leagues button with a side panel. Pro and Ultra. See Leagues column.
- Ticker widget. A bar of match cards for your site's header (Starter and above): live matches first, then the next kick-offs and the latest results, from your featured leagues, all matches or each reader's favourites. When your selection has nothing today it shows the next thing that does and says why. It has no odds or betting links, so no responsible-gambling notice under it. See Ticker and events log.
- Events log (Pro and Ultra): goals with the score at that moment, red cards, missed penalties, kick-off, half-time and full-time, newest first, filled from the day so far. As a side card next to the Livescore (one line and a sheet on phones) or as a strip.
Changed
- Your affiliate link allowance is added to your offers (Pro 10 + 5, Ultra 50 + 20), and buttons in rows, headers and floating cards never count as placements.
- Size, Content, Icon, Target, Advance on click and
Custom CSS classes of affiliate links no longer change anything: links
are offer buttons with one look that open in a new tab, with
rel="sponsored noopener". - Inline odds display looks the same in match rows, in the match header and in the match window. Text only is gone: it already looked like Soft cells in the rows, and configurations that use it now show Soft cells everywhere.
- Over Under and Asian Handicap odds show their line first with the
market's name, such as
O/U 2.5orAH −0.5, in the widget's language. - Use highest odds now picks the bookmaker with the best prices for the whole market and compares goal line and Asian handicap odds on the same line.
- In the match window, the offer strip and the Modal bottom banner now show together, the strip above. Before, the strip took the banner's place.
- Offer units with Follow cards now take the look of the cards around them: the competition groups in the match list, the section cards in the match window and on item pages.
- In the configurator, offer placements are listed one per line; every place you are not using yet is listed below them.
- The Live ticker in the Livescore is now a Pro and Ultra feature. Free and Starter widgets that had it turned on no longer show it.
- On Pro and Ultra the Live ticker now shows match cards (score, minute, kick-off time) instead of cards of the latest events, so it is never empty while the day has matches. Choose the matches and statuses in Live ticker & events log. To get a strip of events back, set Ticker content to Latest events.
Fixed
- Visitors from Argentina outside the city and the province of Buenos Aires saw odds and betting links without any responsible-gambling notice. They now see the default notice, in the widget's language.
- Score position: Next to team names puts the score right after the team names again, in a column aligned across rows. It had moved to the right edge, like Right edge. It is the default, as the configurator now says.
- Modal frame is no longer offered: it only added or removed the window's 1 px outline. The window's frame is Header and tabs (in Item window), Modal size sets its width, and Modal content inset now works with every frame. Saved configurations look the same. See What happens when visitors click.
- The configurator preview follows the Compliance section as you change it.
- Compliance mode offers Standard and Clean (no betting content): Country and Custom behaved exactly like Standard and are kept only for saved configurations.
- Asian Handicap odds in match rows showed the goal line without prices.
- Default bookmaker and Use highest odds now work in match rows. Your plan's bookmaker limit no longer leaves out the default bookmaker.
- The odds and the affiliate button no longer touch the bottom edge of the match window's header.
- A missed penalty was shown as a goal in the match rows (when opened), in the match timeline and in the match header, next to a score that did not count it. It now shows as a missed penalty and is not counted as a goal.
2 October 2026
New
- Your own offers. Pro and Ultra can show their own bonus offers as a list, a grid, a single card or a strip in the match window, with three styles, colour overrides per theme, a featured "Top offer", and an optional bar that stays on screen while readers scroll. Each offer has its own countries, devices and end date. See Your own offers.
- Free widgets can show banners and partner buttons managed by SoccersAPI. See Monetization.
Fixed
- The space between team names and the score, and between tabs, no longer disappears after the widget updates.
- The Modal bottom banner no longer offers a Sticky option: it always sits in the window's footer, in view.
- A banner slot with styling only (for example Sticky or Background) and no image no longer shows an ad served by SoccersAPI. It stays empty until you add an image.
1 October 2026
New
- Header and tabs (in Item window) sets how the header and its tabs sit in the window that opens over the widget: edge to edge, or together in one card with or without a border. By default it follows your layout preset. See What happens when visitors click.
- Toolbar frame and League group frame (in Livescore layout) change the frame of the toolbar and of each competition. See Design your widget.
- The window over the widget and the floating cards have a new header with the item's key facts (a match's score and status, a team's position and next match, a player's club, position and age), in your template's header colours, with the back, minimize and close buttons in its first row.
- The general responsible-gambling notice is translated into the widget's 22 languages. Country texts stay in their country's language.
- The public playground shows sample banners and a sample partner link, so you can see them working before adding your own.
Improved
- Sticky banners stay in view while readers scroll, above the sticky toolbar and headers. See Sticky banners.
- The window takes the widget's light or dark theme, dims the page a little less, and opens without animation for visitors who ask their device for reduced motion.
- The search dialog: in the Carded layout the results sit in one rounded group; rows read right to left in Arabic and Persian; Show more is always reachable on phones.
- The date strip keeps the selected day in view in right-to-left languages.
- Opacity sliders in the configurator move in 1 % steps.
- In the playground, designs exported from older versions of the editor are updated when you import them, with a note that lists what changed and a Keep previous look button.
- The widget script is smaller and loads faster. Nothing changes on screen.
Fixed
- Lineup shirts and names no longer paint over the window's header while scrolling.
- An affiliate button styled Outline, Soft or Link stays readable on a coloured match header.
- A compliance section saved with every notice text empty no longer hides the country's notice.
- Ad-server slots served by SoccersAPI wait for the visitor's country to be detected before asking for an ad, and ask for non-betting ads when it cannot be detected.
30 September 2026
New
- Details & effects: every detail a template sets (glows, bevels, gradients, extra colours and sizes) can now be changed in the configurator. See Design your widget.
- Four new templates: Rabona, Vidiprinter, Tiki-Taka and Golden Goal. See the Template gallery.
- Seven new languages: Georgian, Hindi, Indonesian, Persian (right to left), Romanian, Thai and Traditional Chinese, for 22 in all. Russian, Dutch, Greek, Vietnamese and Arabic widgets now get team and competition names in their own language. See Languages.
- Saved configurations remember their template. If the template changes later, the configurator shows Saved version and Reset to saved design goes back to what you saved.
Improved
- The template gallery was refreshed: Kickoff, Press Box and Floodlights among others, with football names, and some templates were retired. Configurations that use a retired template keep their design.
- The public playground starts on the Kickoff template, in dark.
- On phones, matches, teams, competitions and players open in one full-screen sheet, whether you use Modal or Floating cards.
- Dark themes no longer show a light glow under cards.
- Press Box headers follow its navy toolbar.
Fixed
- Windows no longer open scrolled down to the active filter.
29 September 2026
New
- Base template: the widget's own design with nothing added, first in the gallery.
Improved
- While visitors read further down the livescore, live updates no longer reorder the competitions under them, and each competition keeps its open or closed state.
28 September 2026
New
- Floating cards for teams, competitions and players, not only matches. Choose which types open as cards and how many can stay pinned (1 to 10).
- Team names: Auto, Full name, Shortened name or Team code. Auto shows full names, and codes only on very narrow widgets.
- New public documentation, with a full list of configurator options.
Improved
- Cup brackets scroll round by round.
- Statistic bars follow the corners of your template's buttons.
- Several widgets on one page: each one opens and closes only its own windows.
- The error card shows the real reason when the configuration cannot be loaded.
- The Free iframe paints its own background in the widget's theme.
- The public playground exports the design only; the admin has one Export configuration menu.
- The public playground opens with Floating cards navigation.