SoccersAPISoccersAPIWidgets V2

Configurator options

Every setting in the configurator, with its options, its default and the plans that include it.

This page lists every setting of the configurator with the label you see on screen. To jump to a setting in the configurator, type its label in Find a setting.

  • Settings column (left): how the widget behaves and which parts it shows. Most of these are available on every plan.
  • Current plan column (right): features that depend on your plan or an add-on. In the public playground this column is called Pro controls.
  • Design: colours, shapes, spacing and type. These appear in the Advanced view and in Edit in preview.

A setting that your plan does not include still shows its value, with a lock and a message such as Requires Pro. The live widget ignores it until your plan includes it.

Labels are shown as they appear with the Livescore selected. Some follow the selected widget: Entity navigation, for example, reads Match navigation when Match is selected.

Settings column

Global behavior

SettingWhat it doesOptions
Widget heightLeave at 0 to grow with the content and let the page scroll. With a height the widget scrolls inside itself, which is also what makes sticky toolbars and league headers stick inside the widget instead of the page.0–1200 px. Default: 0 px
Show all entity headersMaster switch for match, league, team and player headers. Each widget keeps its own switch in its header section.On · Off. Default: On
LocaleEnglish · Español · Deutsch · Français · Italiano · Português · Nederlands · Polski · Türkçe · Русский · Ελληνικά · Tiếng Việt · العربية · 中文 · 한국어. Default: English
Compact modeOn · Off. Default: Off

Data

Choose the competitions that the livescore data should prioritize. This setting is available on every plan.

Applies to: Livescore.

SettingWhat it doesOptions
Featured leaguesSearch and pin the competitions that appear first in the livescore feed.Search and pick competitions
Show only featured leaguesUse the featured list as a filter: the feed shows only these competitions. Off keeps every league and lists the featured ones first.On · Off. Default: Off

Entity headers

Controls the header rendered by the selected detail widget. Select Match, League, Team or Player to edit each one.

SettingWhat it doesOptions
Divider under headerA hairline between the entity header and its tabs.On · Off. Default: On
Show match score headerShows the score/team header in match detail views. Only for: Livescore, Match. Shown when Show all entity headers is on.On · Off. Default: On
Show league headerShows the league entity header above league tabs. Only for: League, Leagues. Shown when Show all entity headers is on.On · Off. Default: On
Show team headerShows the team entity header above team tabs. Only for: Team. Shown when Show all entity headers is on.On · Off. Default: On
Show player headerShows the player entity header above player tabs. Only for: Player. Shown when Show all entity headers is on.On · Off. Default: On

Livescore

Applies to: Livescore.

SettingWhat it doesOptions
Default tabToday · Live · Notstarted · Ended · My Games. Default: Today
Date picker modeStrip · Calendar · Both. Default: Strip
Team logos in feedOn · Off. Default: On
Team namesMatch rows in the feed, favourites and fixture lists. Auto shows full names while they fit on one line; when a name would be cut, the whole league block switches to the official team codes (ATL, NYC). Full name wraps to two lines when needed. Shortened name: the name without FC, CF, SC… (e.g. Atlanta United), also used when a team has no code or both teams share one. The full name stays available on hover and to screen readers. Only for: Livescore, League, Team.Auto (fit to space) · Full name · Shortened name · Team code (ATL). Default: Auto (fit to space)
Period scores in rowsHalf-time and full-time columns next to the score, like the portal feed.Off · Final · Final + 1st half · Final + both halves. Default: Off
TV indicatorOn · Off. Default: On
Live tickerGoals and status changes in a horizontal strip above or below the feed.Off · Above the feed · Below the feed. Default: Off
Live ticker cardsCompact: crests and short codes on one line. Extended: full names and the competition. Shown when Live ticker is Above the feed or Below the feed.Compact · Extended. Default: Compact
Live ticker surfaceInherit follows the preset. Joined grid is a rectangular rail for Edge. Shown when Live ticker is Above the feed or Below the feed.Inherit preset · Separate cards · Joined grid. Default: Inherit preset
Keep ticker visibleKeeps the selected strip attached to its top or bottom edge while the feed scrolls. Shown when Live ticker is Above the feed or Below the feed.On · Off. Default: Off

Livescore navigation items

Applies to: Livescore.

SettingWhat it doesOptions
Tab · TodayOn · Off. Default: On
Tab · LiveOn · Off. Default: On
Tab · UpcomingOn · Off. Default: On
Tab · FinishedOn · Off. Default: On
Tab · My matchesOn · Off. Default: On
Action · Date pickerOn · Off. Default: On
Action · SearchOn · Off. Default: On
Action · FavoritesOn · Off. Default: On
Action · Theme toggleOn · Off. Default: On
Action · SettingsOn · Off. Default: On
Odds switchAdds an Odds on/off switch to the toolbar so readers can hide odds (and stop loading them). Shown only when the plan includes odds.On · Off. Default: On
Live as switchMoves the live filter out of the tab row and into a switch next to the date strip.On · Off. Default: Off
Tab countersAll tabs, only the live tab, or none. The totals are also announced above the feed.All tabs · Live only · None. Default: All tabs

Match behavior

Applies to: Match.

SettingWhat it doesOptions
Default tabSummary · Prematch · Events · Lineups · Statistics · Commentary · Standings · H2h · Odds · Tv. Default: Summary
Back buttonOn · Off. Default: On
Odds actionOn · Off. Default: On
TV actionOn · Off. Default: On

Match tabs

Applies to: Match.

SettingWhat it doesOptions
SummaryOn · Off. Default: On
PrematchOn · Off. Default: On
EventsOn · Off. Default: On
LineupsOn · Off. Default: On
StatisticsOn · Off. Default: On
CommentaryOn · Off. Default: On
StandingsOn · Off. Default: On
H2HOn · Off. Default: On
Odds tabOn · Off. Default: On
TV tabOn · Off. Default: On

League behavior

Applies to: League.

SettingWhat it doesOptions
Default tabFixtures · Standings · Topscorers · Teams · Venues. Default: Fixtures
Back buttonOn · Off. Default: On
FixturesOn · Off. Default: On
StandingsOn · Off. Default: On
StatsOn · Off. Default: On
TeamsOn · Off. Default: On
VenuesOn · Off. Default: On

Team behavior

Applies to: Team.

SettingWhat it doesOptions
Default tabSummary · Fixtures · Standings · Players · Transfers · Injuries · Stats. Default: Summary
Back buttonOn · Off. Default: On
SummaryOn · Off. Default: On
FixturesOn · Off. Default: On
StandingsOn · Off. Default: On
PlayersOn · Off. Default: On
TransfersOn · Off. Default: On
InjuriesOn · Off. Default: On
StatsOn · Off. Default: On

Player behavior

Applies to: Player.

SettingWhat it doesOptions
Default tabStats · Career · Participations. Default: Stats
Back buttonOn · Off. Default: On
StatsOn · Off. Default: On
CareerOn · Off. Default: On
ParticipationsOn · Off. Default: On

Components

Visual variants of the parts of the widget: toolbar, rows, headers, tabs and data blocks.

Surfaces

SettingWhat it doesOptions
Default section surfaceSurface for section wrappers. Carded is borderless by default; inner data cards keep their separate Card controls.Inherit preset · Flat · Outlined · Carded. Default: Flat

Livescore layout

Applies to: Livescore.

SettingWhat it doesOptions
Sticky toolbarOn · Off. Default: Off
Toolbar layoutWhere the match tabs sit. Auto uses one row when everything fits and two rows below that; under 560px the toolbar always uses two rows.Auto (fits the width) · Two rows, tabs below · Two rows, tabs on top · One row. Default: Auto (fits the width)
Tabs separatorLine between the tabs row and the dates and actions row, drawn whenever the toolbar uses two rows.None · Full width · Inset. Default: None
Sticky league headerKeeps an expanded league header visible while its matches scroll.On · Off. Default: Off
Match separatorsHairline between the matches of a league group. If the layout's separator color is transparent, turning this on also gives it a subtle visible color ("Match separator" in Colors & surfaces).On · Off. Default: Off
League header separatorShows a divider below every league header, including collapsed groups.On · Off. Default: On
Open all in liveOn · Off. Default: On
Default open groups0–8. Default: 4
Sort feed byPriority and league modes keep one group per league. Kickoff schedule groups first by start time, then by league, so a league can repeat across time slots.Priority (featured + live) · League name (A-Z) · Kickoff schedule. Default: Priority (featured + live)
League rowChanges only the arrangement. Text size, logo scale and metadata stay consistent.Default · Inline. Default: Default
Leading visualLeague logo · Country flag · No icon. Default: League logo
Country flag in metadataOn · Off. Default: Off
Match rowChoose the disposition only. Typography and score treatment stay consistent.Default · Inline · Inline · crests outside. Default: Default
Expandable rowsRows expand inline showing goal scorers and quick actions without leaving the list.On · Off. Default: Off
Score displayChoose one maintained score recipe. Existing legacy variants remain compatible.Clean · Solid · joined · Solid · separate · Outline · joined · Outline · separate. Default: Clean
Match layoutList stacks rows vertically; Grid renders matches as auto-sized cards. Only for: Livescore, League, Team.List · Grid. Default: List
Score positionEdge pins the score to the right of the row; Inline puts it next to the team names with a max-width on team names. Only for: Livescore, League, Team.Right edge (default) · Next to team names. Default: Right edge (default)
Livescore tabsSolid fills the active tab. Underline marks it with a rule under the label. Flat drops the box entirely and marks it with ink and weight.Solid · Underline · Flat. Default: Solid

Icon buttons

Applies to: Livescore, Match, League, Team, Player.

SettingWhat it doesOptions
Icon button sizeShared visual size for favorite, pin, expand and toolbar icon buttons. Touch target remains accessible independently.18–40. Default: 28

Entity header

Applies to: Livescore, League, Leagues, Team, Player.

SettingWhat it doesOptions
Team header layoutOnly affects team profiles. Standard keeps the club mark balanced with the identity details. Only for: Team.Follow default · Minimal · Standard profile · Centered profile. Default: Follow default
League header layoutOnly affects competition profiles. Only for: League, Leagues.Follow default · Minimal · Standard profile · Centered profile. Default: Follow default
Player header layoutOnly affects player profiles. Only for: Player.Follow default · Minimal · Standard profile · Centered profile. Default: Follow default
FrameFollow the layout preset, integrate the header, or separate it as a card.Follow layout preset · Integrated · Separate card. Default: Follow layout preset
Color treatmentNeutral by default; entity color is used only when the API provides a valid team or league color.Neutral · Accent tint · Entity color. Default: Neutral
Sticky entity headerOn · Off. Default: Off

Entity navigation

SettingWhat it doesOptions
Primary tabsSolid fills the active tab. Underline marks it with a rule under the label. Flat drops the box entirely and marks it with ink and weight.Solid · Underline · Flat. Default: Underline
Inner tabsSection default keeps each section's own style (chips; underlined in Fixtures). Any other choice applies to every inner tab bar.Section default · Solid · Flat · Chip · Pill · Compact · Underline. Default: Section default

Fixture headings

Applies to: League, Team.

SettingWhat it doesOptions
Sticky fixture headingsKeeps the current date heading visible while its fixtures scroll.On · Off. Default: Off
Bordered fixture controlsAdds the same optional border used by compact icon controls. Only for: League.On · Off. Default: Off
Fixture heading size9–18 px. Default: 11 px
Fixture heading shapeFlat · Rounded · Pill. Default: Flat

Match header

A small set of maintained header recipes. Frame and color are independent and have one clear responsibility each.

Applies to: Livescore, Match.

SettingWhat it doesOptions
LayoutChanges the score, teams and competition hierarchy at every supported width.Minimal · Standard · Centered. Default: Standard
FrameFollow the layout preset, integrate the header, or separate it as a card.Follow layout preset · Integrated · Separate card. Default: Follow layout preset
Color treatmentNeutral · Accent tint · Dark. Default: Neutral
Sticky header on scrollOn · Off. Default: Off
Score displayApplies to the match header only. Livescore rows keep their own score display because they use a different layout.Clean · Solid. Default: Clean

Data & match content

Applies to: Livescore, Match.

SettingWhat it doesOptions
Match info layoutChoose the information section layout inside Summary.Cards grid · Compact list. Default: Cards grid
Player photos on pitchUse player photos instead of shirt markers in lineups.On · Off. Default: Off
Venue image in match headerAdds the venue photograph behind the score header when one is available.On · Off. Default: Off
Bet link placementWith the odds: after the odds, or in their place when a match has none (at the start of the card footer in Grid). Under the status and Own line keep the older layouts. Only for: Livescore, League, Team.With the odds · Under the status · Own line. Default: With the odds
Match header team namesAuto shows the full names while they fit (two lines in the standard header, one line in the minimal one) and switches both teams to the official team code (ATL) when they would be cut. Shortened name: the name without FC, CF, SC… (e.g. Atlanta United), also used when a team has no code. The full name stays available on hover and to screen readers.Auto (fit to space) · Full name · Shortened name · Team code (ATL). Default: Auto (fit to space)
Match summary chartPressure chart draws minute-by-minute pressure from shots, corners, set pieces and goals. Event timeline marks goals, cards and substitutions on a single axis. Only for: Match.Pressure chart · Event timeline. Default: Pressure chart
Match statsAll groups keeps the family filters (attack, discipline, passing). Key stats only drops them and shows the main figures. Only for: Match.All groups · Key stats only. Default: All groups
StandingsFull table shows W/D/L, goals and form as the width allows. Position and points keeps only rank, team, played, GD and points. Only for: Match, League, Team.Full table · Position and points. Default: Full table
Top scorersOnly for: League.Full · Compact · Cards · Grid. Default: Compact
Top scorers stripedOnly for: League.On · Off. Default: Off
Standings stripedOnly for: Match, League, Team.On · Off. Default: Off
Team listOnly for: League.List · Card · Card Row. Default: List
Player listOnly for: Team.Squad · Lineup · Card · Card Row. Default: Squad
Team competitions layoutGrid renders competition cards in auto-fit columns; List stacks them vertically with separators. Only for: Team.Grid · List. Default: List

Current plan column

Features included in some plans only. Each section shows the plans that include it.

Entity navigation

Plans

Choose where matches, teams, leagues and players open when clicked. Modal, In-widget content, Floating cards and None come with advanced navigation. Dynamic Pages adds links to your own pages on domains with the add-on.

SettingWhat it doesOptions
Navigation modeWhere matches, teams, leagues and players open when clicked. Modal opens details over the list; any match, team, league or player modal can be minimized to a floating card (under 900 px it becomes a chip in the bottom tray). In-widget content replaces the list with the entity view. Floating cards pin the matches, teams, leagues and players you click (untick a type under Open as floating card to keep it in the modal): from 900 px a pin opens expanded at the bottom corner of the widget with the whole match, team, league or player inside in compact form (every tab, header and tabs fixed, content scrolling; a league keeps its season selector); minimize it to keep following it as a live chip (score, minute, last key event; a team follows its live, last or next match, and a player the match of his team; a league shows how many of its matches are live) in the pinned bar, or open the full view. On widgets under 900 px pins sit in a bottom tray and open in a sheet with the same miniature, previous and next, and Open full view. Dynamic Pages options appear only for domains where the add-on is active. None keeps the widget simple: nothing opens. Dynamic Pages needs the Dynamic Pages add-on.Modal · In-widget content · Floating cards · Dynamic Pages · None (no entity links). Default: Modal
Open as floating card › MatchesUnchecked types open in the modal, without Minimize to floating card. Shown when Navigation mode is Floating cards.On · Off. Default: On
Open as floating card › TeamsShown when Navigation mode is Floating cards.On · Off. Default: On
Open as floating card › LeaguesShown when Navigation mode is Floating cards.On · Off. Default: On
Open as floating card › PlayersShown when Navigation mode is Floating cards.On · Off. Default: On
Max pinned itemsHow many items (matches, teams, leagues, players) can stay pinned at once (1 to 10). Every pinned card that fits side by side stays expanded (three on widgets from 1000 px, two at 900 to 999 px); the rest keep following as live chips in the pinned bar and never close for lack of room. Pinning one more than this maximum removes the least recently used chip, or the least recently used card when none is a chip (never the item you just pinned). In Modal mode, pins come from the Minimize to floating card button of an entity modal. Shown when Navigation mode is Floating cards or Modal.1–10. Default: 5
Modal sizeShown when Navigation mode is Modal or Floating cards.Auto (2XL, sheet on mobile) · Small · Medium · Large · Extra large · 2XL · 3XL · 4XL · Full screen. Default: 2XL
Modal anchorWhere dialogs and popovers hang: inside the widget, so they stay inside its area and follow its scroll, or on the page, so they can cover the whole screen. Auto lets the host decide, which is what it did until now.Auto (host decides) · Inside the widget · On the page. Default: Auto (host decides)
Modal frameControls only the entity content edge. It does not change the dialog width: use Modal size for that. Shown when Navigation mode is Modal or Floating cards.Edge-to-edge · Carded. Default: Edge-to-edge
Modal headerA control band at the top of the dialog with back, title, favourite and close. Turn it off to fall back to a floating close button over the content. Shown when Navigation mode is Modal or Floating cards.On · Off. Default: On
Modal content insetInner spacing around the entity view. Available only for Carded; Edge-to-edge always has no inset. Shown when Navigation mode is Modal or Floating cards and Modal frame is Carded.0–32 px. Default: 0 px

Dynamic Pages

Plans

Configure real entity URLs, link targets and metadata broadcast for approved domains with the Dynamic Pages add-on.

SettingWhat it doesOptions
Match URL baseUsed by Dynamic Pages link and router modes. Example: match creates /en/match/slug/id. Shown when Navigation mode is Dynamic Pages or Navigation mode is Dynamic Pages router (legacy).Text. Default: matches
Match link targetOnly for Dynamic Pages link mode. Same tab keeps the user in place; New tab writes target="_blank" with safe rel attributes. Shown when Navigation mode is Dynamic Pages.Same tab · New tab · Parent frame · Top frame. Default: Same tab
League URL baseUsed by Dynamic Pages link and router modes. Example: league creates /en/league/slug/id/seasonid. Shown when Navigation mode is Dynamic Pages or Navigation mode is Dynamic Pages router (legacy).Text. Default: leagues
League link targetOnly for Dynamic Pages link mode. Controls whether league links open in the same tab, a new tab, parent frame or top frame. Shown when Navigation mode is Dynamic Pages.Same tab · New tab · Parent frame · Top frame. Default: Same tab
Team URL baseUsed by Dynamic Pages link and router modes. Example: team creates /en/team/slug/id. Shown when Navigation mode is Dynamic Pages or Navigation mode is Dynamic Pages router (legacy).Text. Default: teams
Team link targetOnly for Dynamic Pages link mode. Controls whether team links open in the same tab, a new tab, parent frame or top frame. Shown when Navigation mode is Dynamic Pages.Same tab · New tab · Parent frame · Top frame. Default: Same tab
Player URL baseUsed by Dynamic Pages link and router modes. Example: player creates /en/player/slug/id. Shown when Navigation mode is Dynamic Pages or Navigation mode is Dynamic Pages router (legacy).Text. Default: players
Player link targetOnly for Dynamic Pages link mode. Controls whether player links open in the same tab, a new tab, parent frame or top frame. Shown when Navigation mode is Dynamic Pages.Same tab · New tab · Parent frame · Top frame. Default: Same tab
Broadcast entity metadataDynamic Pages only. Emits the currently opened entity so hosts can update page metadata or external state.On · Off. Default: Off

Pro branding

Plans

Hide the default widget branding or replace it with your own logo, name and link.

Applies to: Match, League, Leagues, Team, Player.

SettingWhat it doesOptions
Custom logo positionLeft · Center · Right. Default: Left
Custom logo size20–300. Default: 120
Custom logo URLText, for example https://...
Custom logo URL · darkText, for example https://...

Pro streaming

Plans

A where-to-watch call to action in the match TV tab: it links the broadcasters of a match to your streaming or affiliate partners.

Applies to: Livescore, Match.

SettingWhat it doesOptions
Streaming module in matchShow a video-player promo block in the match TV section.On · Off. Default: Off
Compact (player + CTA only)Hide title, description and steps. Just show the player with the CTA. Shown when Streaming module in match is on.On · Off. Default: Off
TitleSupports {home}, {away}, {broadcaster}, {country}. Shown when Streaming module in match is on.Text. Default: How to watch {home} vs {away} online live stream & on TV
DescriptionSupports {home}, {away}, {broadcaster}, {country}. Shown when Streaming module in match is on.Text. Default: {home} vs {away} is available on {broadcaster}
Step 1Shown when Streaming module in match is on.Text. Default: Sign in or create your account
Step 2Shown when Streaming module in match is on.Text. Default: Purchase a subscription if required
Step 3Shown when Streaming module in match is on.Text, for example Optional
Player backgroundCustom background for the fake player. Leave empty to use the default stadium gradient. Shown when Streaming module in match is on.Colour
CTA URLRequired for the player: without a destination URL (here or from the channel catalog) and an identified broadcaster, the player is not shown and the block shows only the text. Shown when Streaming module in match is on.Text, for example https://…
CTA label · mainRight-side info column button. Shown when Streaming module in match is on.Text, for example View streaming options
CTA label · playerPill overlay on the player itself. Shown when Streaming module in match is on.Text, for example Watch now
Disclaimer textShown below the streaming module. Leave empty to hide. Shown when Streaming module in match is on.Text, for example This page does not host live streams…

Pro streaming · channel catalog

Plans

Add a default URL for each channel. When the broadcast feed lists a matching channel, the URL is attached automatically.

Applies to: Livescore, Match.

Fields of each item

These fields repeat for each of the 21 items: bet365, DAZN, ESPN, ESPN+, Fubo TV, beIN Sports, Sky Sports, Sky Go, TNT Sports, Movistar+, Canal+, Amazon Prime Video, Apple TV+, Paramount+, Peacock, Stan Sport, Optus Sport, Disney+, Star+, ViX, TUDN.

SettingWhat it doesOptions
EnabledOn · Off. Default: Off
URLText, for example https://…
WeightHigher = more likely in Featured. 0–100.0–100. Default: 50

Pro livescore sounds

Plans

Goal, kickoff, half-time and full-time sounds for live matches, with per-event toggles and volume.

Applies to: Livescore.

SettingWhat it doesOptions
Enable soundsOn · Off. Default: On
Sound volume0–1. Default: 0.3
Goal soundOn · Off. Default: On
Kickoff soundOn · Off. Default: On
2nd-half startOn · Off. Default: On
Half-time soundOn · Off. Default: On
Extra 1 startOn · Off. Default: On
Extra 1 endOn · Off. Default: On
Extra 2 startOn · Off. Default: On
Extra 2 endOn · Off. Default: On
Penalties soundOn · Off. Default: On
Full-time soundOn · Off. Default: On

Compliance

Plans

Country profiles supply the responsible-gambling notice, the advertising label and the minimum age on every plan; they no longer block commercial content by themselves. Pro and Ultra declare the delivery policy here: a site jurisdiction, restricted visitor countries or a fully clean mode.

Policy

SettingWhat it doesOptions
Compliance modeInherit · Clean · Country · Custom. Default: Inherit
Site jurisdictionISO country code governing the site, for example IT.Text, for example IT
Restricted visitor countriesComma-separated ISO country codes that must receive clean delivery.Text, for example IT, ES
Block betting when country is unknownOn · Off. Default: On

Betting surfaces

SettingWhat it doesOptions
Disable all oddsOn · Off. Default: Off
Disable bookmaker linksOn · Off. Default: Off
Disable affiliate linksOn · Off. Default: Off
Disable commercial bannersOn · Off. Default: Off
Hide bookmaker logosOn · Off. Default: Off

Notice text

SettingWhat it doesOptions
Show compliance noticeOn · Off. Default: On
Responsible-gambling textText
Resource link labelText
Resource URLText, for example https://...
Help textText
Help URLText, for example https://...
Additional compliance textText

Plans

Monetize match rows and headers with affiliate buttons: link slots, rotation and click strategy. Until you enable a slot with its URL, the preview shows the default link of the base configuration (Bet365); Size, Content, Icon and style apply to the slots you enable here, which replace it.

Applies to: Livescore, Match.

SettingWhat it doesOptions
Affiliate links enabledOn · Off. Default: On
Show in match rowsOnly for: Livescore. Shown when Affiliate links enabled is on.On · Off. Default: On
Show in match headerShown when Affiliate links enabled is on.On · Off. Default: On
Advance on clickShown when Affiliate links enabled is on.On · Off. Default: On
Rotate linksShown when Affiliate links enabled is on.On · Off. Default: Off
Rotation interval (s)Shown when Affiliate links enabled is on.5–600. Default: 30
Start strategyShown when Affiliate links enabled is on.Session Hash · First · Random. Default: Session Hash

Fields of each item

These fields repeat for each of the 20 items: Link 1, Link 2, Link 3, Link 4, Link 5, Link 6, Link 7, Link 8, Link 9, Link 10, Link 11, Link 12, Link 13, Link 14, Link 15, Link 16, Link 17, Link 18, Link 19, Link 20. Your plan sets how many of them can be active.

SettingWhat it doesOptions
EnabledOn · Off. Default: Off
LabelText. Default: Bet now
DescriptionText, for example Optional helper text
URLText, for example https://...
TypeButton · Text. Default: Button
Button styleSolid fills with the brand colour; Gradient shades it towards a darker tone (angle in Colors → Gradients); Outline and Soft keep the row quiet; Neutral uses the control grey; Text link drops the box.Solid · Gradient · Outline · Soft · Neutral · Text link. Default: Solid
SizeXS is the compact row button (24px tall, 11px text); Small is the default.XS · Small · Medium · Large. Default: Small
ContentIcon only keeps the label as the accessible name and tooltip, and renders a square button the same height as the text version.Text · Icon + text · Icon only. Default: Text
IconArrows sit after the label; every other icon sits before it.Arrow (external) · Arrow right · Chevron · External link · Link · Anchor · Gift · Lightning · Tag · Percent · Award · Trending up · Play · Target. Default: Arrow (external)
ColorText. Default: primary
TargetBlank · Self. Default: Blank
Target countriesText, for example ES, GB
Restricted countriesText, for example US, BR
Restricted devicesText, for example mobile, desktop
Weight1–100. Default: 1
Custom CSS classesAdds your own class names to the button (<a class="ls-affiliate-link my-cta">) so the stylesheet of YOUR page can restyle it. Example: type my-cta here, then add .my-cta { border-radius: 999px; } to your page CSS. Native embed only: an iframe cannot read your CSS. Tailwind classes (rounded-full, px-4) work only if your page already loads Tailwind; the widget does not generate them. For colour, shape and size use Button style, Color and Size above.Text, for example my-cta my-cta--featured

Bookmaker odds

Plans

Choose where odds appear and which bookmaker supplies highlighted odds. Highest odds wins when enabled; otherwise the default bookmaker is used, then catalog priority as fallback.

Applies to: Livescore, Match.

SettingWhat it doesOptions
Bookmaker odds enabledMaster switch for bookmaker odds: off hides the odds in match rows, in the match header and the Odds switch of the toolbar.On · Off. Default: On
Inline odds in match rowOnly for: Livescore. Shown when Bookmaker odds enabled is on.On · Off. Default: On
Odds in match headerShown when Bookmaker odds enabled is on.On · Off. Default: Off
Show bookmaker logoShown when Bookmaker odds enabled is on.On · Off. Default: On
Inline odds displayShown when Bookmaker odds enabled is on.Text only · Outlined cells · Soft cells · Chips · Solid cells. Default: Text only
Inline odds sizeShown when Bookmaker odds enabled is on.Extra small · Small · Medium · Large. Default: Small
Bookmaker logo sizeRelative to the height of the odds buttons, so it stays in proportion at every odds size. The logo keeps its width in every row. Shown when Bookmaker odds enabled is on and Show bookmaker logo is on.Compact (70%) · Reduced (85%) · Match odds height · Large (115%). Default: Match odds height
Custom CSS classesAdds your own class names to the odds group (<a class="ls-v2-inline-odds my-odds">) so the stylesheet of YOUR page can restyle it. Example: type my-odds here, then add .my-odds { --ls-odds-cell-width: 44px; } (cell width) or .my-odds .ls-v2-inline-odds__cell { font-weight: 800; } (cells) to your page CSS. Native embed only: an iframe cannot read your CSS. Tailwind classes work only if your page already loads Tailwind. Shown when Bookmaker odds enabled is on.Text, for example my-odds my-odds--compact
Default marketShown when Bookmaker odds enabled is on.1x2 · Over Under · Asian Handicap. Default: 1x2
Use highest oddsFor each match, shows the bookmaker paying the most (home price first, then draw, then away) instead of the Default bookmaker. It only changes something when the data carries more than one bookmaker for that match: the livescore feed currently receives one (bet365), the match Odds tab usually several. Shown when Bookmaker odds enabled is on.On · Off. Default: Off
Default bookmakerShown when Bookmaker odds enabled is on and Use highest odds is off.A bookmaker from the catalogue. Default: bet365

Bookmaker catalog & priority

Plans

Controls the bookmakers eligible for highlighted odds and comparison tables. Priority is the fallback order when the default bookmaker has no odds; lower numbers appear first.

Applies to: Livescore, Match.

Fields of each item

These fields repeat for each of the 39 items: 10Bet, bet365, 188Bet, 888Sport, Bet Fred, Bet-At-Home, BetFair, BetVictor, Coral, Dafabet, Everygame, Marathonbet, Paddy Power, Pinnacle, Unibet, Betsson, Interwetten, BWin, TitanBet, Ladbrokes, 1xbet, Betway, WilliamHill, Betclic, CloudBet, SBOBET, Nitrogen, Winner, BetRegal, SkyBet, MarsBet, Macauslot, GGBet, Betdaq, PlanetWin365, Mansion, CashPoint, MelBet, Betika.

SettingWhat it doesOptions
EnabledOn · Off. Default: On
Fallback priority0–10. Default: 1
Restricted countriesText, for example ES, GB, BR
Restricted devicesText, for example mobile, desktop
URLText, for example https://...

Pro banners

Plans

Banner ad slots across widget placements, each with its own image, link and visibility rules.

Fields of each item

These fields repeat for each of the 6 items: Top banner, Bottom banner, Entity top banner, Entity bottom banner, Modal top banner, Modal bottom banner.

SettingWhat it doesOptions
EnabledOn · Off. Default: On
Alt textText, for example Sponsored banner
BackgroundText. Default: transparent
Click URLText, for example https://...
Image URLText, for example https://...
PaddingNone · Sm · Md. Default: None
Sticky top / Sticky bottomOn · Off. Default: Off
Custom CSS classesAdds your own class names to this banner's container so the stylesheet of YOUR page can restyle it. Example: type my-banner here, then add .my-banner { border-radius: 8px; overflow: hidden; } to your page CSS. Native embed only: an iframe cannot read your CSS. Tailwind classes (shadow-lg rounded-md) work only if your page already loads Tailwind; the widget does not generate them.Text, for example my-banner my-banner--featured
RelText. Default: noopener noreferrer
TargetBlank · Self. Default: Blank
Tracking pixelText, for example https://...
Size0–1200. Default: 468

Design

Fine-grained design settings. A template or the Basic view sets most of them for you.

Colors

Public palette. Component-specific colors are derived automatically from these values.

SettingWhat it changes
AccentBrand color.
Widget shellOuter background; transparent blends into the host site.
CanvasInternal fallback behind widget surfaces.
SurfaceCards and primary section surfaces.
Surface mutedMuted fills, placeholders and tertiary surfaces.
Text · primary
Text · secondary
Text · muted
Border
Live · text
PositivePositive stats (GD, wins)
NegativeNegative stats (losses, red)

Advanced controls

Low-level colors for chips, tabs, pills and active controls.

SettingWhat it changes
Accent softSoft accent fills and highlights.
Control bgChips, pills, inactive controls.
Control textText on inactive chips and small controls.
Control hover bgShared hover for tabs and icon buttons; set opacity to 0 to disable it.
Loading placeholderColour of the skeleton shapes while data loads. Follows the text colour of the theme until set.
Row hover bgGlobal hover for rows and list items (lists, calendar days, H2H and country rows…). League and match rows use it unless they have their own.
Active state bgSelected tabs and active chips.
Active state textText/icons on selected tabs and active buttons.

Advanced surfaces

Low-level surface colors. Prefer entity/livescore surface sections for normal configuration.

SettingWhat it changes
PanelSecondary panels, table heads and inner bands.
Panel textText rendered directly on panel backgrounds.
Container bgContained wrappers and grouped blocks.
Section card bgOuter section wrappers. Separate from inner data cards.
Container textText rendered directly on contained wrappers.
Data panel bgLive and match data panels (pressure, possession, shots, timeline, cards, statistics). Transparent = outlined panel on the canvas; a colour fills them like section cards.
Metric tile bgHeadline figure tiles (matches, goals, channels…). Until set: a soft tint of the text colour in light palettes, and the section surface lifted slightly in dark ones, so it keeps the template hue.
Card bgInner cards inside match/team/league sections (stats, lineups, odds…)
Section header bgSoft header strips and section tops.
Section header textText on section header backgrounds.
Item bgSmall tiles, subrows and inline items.
Item textText on small tiles, subrows and inline items.
List item bgGeneric list rows and cards.
Section dividerBoundary below card and section headings.
Section divider widthThickness of the line below card and section headings; independent from the card frame.
Row dividerHairline between table and entity-list rows (transparent by default: rows separate by height, only section headings draw a line); independent from match-feed separators.
Entity wrapper bgEntity pages and sidebar shells.
Sticky entity header bgOpaque surface used after an entity header reaches its sticky position.

Advanced charts

Chart and stat rail colors.

SettingWhat it changes
Home highlightHome-side charts and match accents.
Away highlightAway-side charts and match accents.
Progress trackChart tracks and neutral stat rails.

Advanced entity headers

Generic entity header colors for league/team/player. Match has its own header colors.

SettingWhat it changes
Header gradient startGeneric entity header gradient start color.
Header gradient endGeneric entity header gradient end color.
Header solid bgGeneric entity header background for Solid and Gradient treatments. Switch to Gradient to set angle and stops.

Advanced competition states

Competition state colors for lineups, form and standings zones.

SettingWhat it changes
Pitch bgLineups pitch background.
Pitch linesColor of pitch markings (touchlines, circles, spots)
Form · winWin indicator in form dots.
Form · lossLoss indicator in form dots.
UCL zoneChampions League qualification bar.
UEL zoneEuropa League qualification bar.
UECL zoneConference League qualification bar.
Relegation zoneRelegation zone bar.

Radius

Radius controls for containers, cards and buttons. Edge presets can still keep rounded controls where useful.

SettingWhat it changes
Radius · League groupOuter frame around a league and its matches.
Radius · League rowLeague header and hover state.
League crest shapeRound crops the crest to a circle, which is what a national cup needs: there the crest IS the country flag. Square leaves it as it comes.
Radius · Match rowMatch rows and their hover state.
Radius · Data rowsShared shape for standings, players, teams and all generic data-list rows.
Radius · CardEntity cards and modals.
Section card borderFrame around section wrappers; separate from inner data-card borders.
Buttons, chips & solid tabsOne shared shape for buttons, chips, badges and solid tabs. Stat bars follow it too.
Card elevation
Sticky elevationShared elevation for fixed livescore elements.
Sticky entity elevationElevation shown only while an entity header is fixed.

Density

A small set of size controls. Spacing follows the balanced product rhythm and the active layout preset.

SettingWhat it changes
Content horizontal paddingShared text inset: toolbar, league headers, section titles, tabs and every data row. Set 0 for edge-to-edge content.
League groups outer insetHorizontal space between the widget edges and the league groups. 0 keeps groups edge-to-edge; the text inset inside rows is "Content horizontal padding".
Match row minimum heightMinimum height for list and inline rows; content grows instead of being clipped.
Match row logoTeam logo size in match rows.
Score widthWidth of the score column in match rows.
Odds column widthMinimum width reserved for inline odds in match rows, so the columns line up between rows.
League group borderOuter border width for league groups.
League row minimum heightMinimum height for the league header; the row grows if its name or country needs more room.
League row logoLeague logo size in the league header.
League header separator widthThickness of the divider below every league header.
Data row outer insetHorizontal breathing room for standings and every data list. Set 0 for edge-to-edge rows.
Data row outer spacingVertical breathing room around standings and every data list row. Set 0 for continuous rows.
Content gapVertical space between competitions in a feed. Default stays continuous: what separates one competition from the next is its own header. With Carded groups the space between cards is Card gap.
Section gapVertical space between sections and cards inside a tab.
Card gapSpace between cards in a grid, and between competitions when groups are carded.
Date strip · day widthWidth of each visible day in the date strip.

Typography

SettingWhat it changes
Font
Score fontFont family for scores and other numeric values.
Base weightRegular keeps the designed hierarchy. Heavier bases move every weight up by the same step.
Global scaleMultiplier for all font sizes.
Line heightLine height of match and league rows (team and league names), in the feed and in fixture lists. Headers and detail sections keep their own spacing.
Text transform
Tabs caseCasing for primary tabs, section tabs and filter chips. Inherit follows Text transform.
Font style
Primary row textShared identity size for teams, leagues and leading players in lists.
Secondary row textShared size for lineups, odds and subordinate list rows.
Body textDescriptions, commentary and non-numeric content cells.
Metadata textTimes, countries, phases and supporting labels.
Score weightWeight of the match score in headers and rows.
Primary row weight
Secondary row weight
Metadata weight
Team nameMatch row team names.
League rowLeague header row text.
League countryCountry label in the league header. Defaults to the current league-row size until overridden.
ScoreMatch row score numbers.
Time / statusMatch row time and status text.
Section titleSection and block headings.
Section title weightWeight used by card and block headings.
Section title caseLetter case used by card and block headings.
Tab textNavigation and content tabs.
Date numberDate strip number size.
Date weekdayDate strip weekday label size.
Header team nameMatch entity team names.
Header team compactMatch entity team names on mini/compact headers.
Header scoreMatch entity score size.
Header score compactMatch entity score size on narrow widths.
Header score weightFont weight of score numbers and their separator in Match Detail.
Entity name sizeTeam / league / player names in entity and match headers.
Entity name weightTeam / league / player name weight in entity and match headers.
Entity crest sizeTeam / league / player mark inside entity headers.

Advanced tokens with verified direct effect in v2.

SettingWhat it changes
Modal Bg
Modal Backdrop Color

Livescore surfaces

Only for: Livescore.

Explicit colors for Livescore. These override the global palette only for the feed, rows and toolbar.

SettingWhat it changes
Toolbar bgTop navigation surface.
Sticky toolbar bgOpaque surface used after the toolbar reaches its sticky position.
Tabs separatorLine between the two toolbar rows.
Toolbar borderLine under the toolbar while it is pinned (and the frame of a carded toolbar)
Date active textText over the selected date background.
League group bgBackground of each league block.
League row bgLeague header row surface.
League row textCompetition name on the league row.
League row country textCountry (and its separator) on the league row. Follows Text · secondary until set; set it when the league row has its own background.
League header separatorDivider below every league header.
Widget gradient startSet start and end to paint the widget shell with a gradient; transparent = off (solid shell colour)
Widget gradient endEnd colour of the widget shell gradient.
Toolbar gradient startStart colour of the toolbar gradient; transparent = off (solid toolbar colour)
Toolbar gradient endEnd colour of the toolbar gradient.
League row gradient startStart colour of the league header gradient; transparent = off (solid league row colour)
League row gradient endEnd colour of the league header gradient.
Gradient angleDirection of the Gradient affiliate button and of gradients saved before per-surface fills (135 = top-left to bottom-right). Each surface fill has its own angle.
Hover transitionHow long hover colours take to change; 0 = instant.
Match row bgIndividual match row surface.
League row hover bgLeague header row while the pointer is over it (falls back to the global hover)
League row hover textCompetition name while the pointer is over the league row. Follows League row text until set; set it when the hover bg is dark or strong.
Match row hover bgRow surface while the pointer is over it (falls back to the global hover)
Match row hover textTeam names while the pointer is over a match row. Follows Match row text until set.
Match row textTeam names and neutral row text.
Match row borderIndividual match row border.
Match separatorHairline between match rows.
Score bgBackground fill for solid score recipes.
Score textScore number color (overrides match row text)
Score borderBorder color for the Outline score recipes.
Live ticker railOpaque rail surface while the ticker is sticky; inherits the feed surface by default.
Live ticker cardEvent card fill; inherits the preset card surface by default.
Live ticker card borderEvent-card border and joined-grid dividers.

Match entity surfaces

Only for: Match.

Explicit surface colors for the match entity view. These override the global palette only in this entity.

SettingWhat it changes
Entity bgFull entity view background.
Entity surface bgHeader, tabs and section card surface.
Entity borderEntity card and panel border.
Header gradient startUsed when Match header background is Gradient.
Header gradient endUsed when Match header background is Gradient.
Header solid bgUsed by Solid, Gradient and Accent gradient header backgrounds. Switch to Gradient to set angle and stops.
Header dark bgUsed when Match header background is Dark.

League entity surfaces

Only for: League.

Explicit surface colors for the league entity view. These override the global palette only in this entity.

SettingWhat it changes
Entity bgFull entity view background.
Entity surface bgHeader, tabs and section card surface.
Entity borderEntity card and panel border.

Cup bracket

Only for: League.

Match boxes and connectors of the cup bracket. Defaults follow the match row (Default) or the section card (Carded).

SettingWhat it changes
Match box bgSurface of each tie in the bracket.
Match box borderFrame of each tie (always 1px; transparent = no frame)
Match box radiusCorners of each tie.
Match box hover bgTie under the pointer or with keyboard focus. The rest of the team path uses the secondary selection tint.
Connector colorLines between rounds. The highlighted path uses the secondary selection ink.
Connector widthThickness of the lines between rounds.

Leagues surfaces

Only for: Leagues.

Explicit controls for the competitions browser and its country/league cards.

SettingWhat it changes
Card bgFeatured league cards and country groups.
Row hover bgCountry rows and league links on hover. Only this directory: tabs and icon buttons keep Control hover bg.

Leagues layout

Only for: Leagues.

SettingWhat it changes
Content gutterText and controls inset; country and league rows remain edge-to-edge.
Card paddingInner spacing for featured league cards.
Card min widthMinimum width for featured league cards before wrapping.

Team entity surfaces

Only for: Team.

Explicit surface colors for the team entity view. These override the global palette only in this entity.

SettingWhat it changes
Entity bgFull entity view background.
Entity surface bgHeader, tabs and section card surface.
Entity borderEntity card and panel border.

Player entity surfaces

Only for: Player.

Explicit surface colors for the player entity view. These override the global palette only in this entity.

SettingWhat it changes
Entity bgFull entity view background.
Entity surface bgHeader, tabs and section card surface.
Entity borderEntity card and panel border.

On this page