SoccersAPISoccersAPIWidgets V2

Design your widget

A tour of the configurator, from templates and the Basic view to every setting, the preview and moving designs between accounts.

The configurator is where you design a widget and decide how it behaves. It shows your changes live, on real or demo data, before anything reaches your site. Every setting is listed with its options in Configurator options.

The configurator

The three columns

  • Left: settings. The widget you are designing, its template and every setting, in a Basic or an Advanced view. Find a setting searches labels, descriptions and the part of the widget a setting changes; Edited lists only what you have changed.
  • Middle: preview. The widget as visitors will see it, with Live data or Demo data, a Width selector, a zoom menu and Edit in preview.
  • Right: your plan. In the admin this column is called Current plan. It shows your plan, how many of its features are enabled, and the settings that depend on your plan: navigation, Dynamic Pages, compliance, sounds, odds, affiliate links, offers, banners, branding and where-to-watch links. Features your plan does not include are grouped under Not in your plan, with a lock and a note such as Requires Pro. In the public playground the same column is called Pro controls.

In the public playground, the banner slots and the offers start with sample content (creatives marked SAMPLE AD, a Your partner Button offer in the match rows and headers, and three offers marked (SAMPLE)) so you can see them working. The panel tags them Sample; replace them with your own creative, links and offers. Samples stay in the playground: they are not part of an exported design and never reach your widget. The public playground also opens with the Kickoff template in dark and the Floating cards navigation mode; the admin and the widget keep Modal as the default.

In the admin, the editor sits next to the Configurations, Domains and Get code tabs. On a screen narrower than 900 px the columns become tabs too: Settings, Preview and Plan and features.

Basic and Advanced

Basic keeps the decisions that change the look at a glance:

  • Layout preset;
  • Color scheme: light or dark;
  • Primary color: buttons, links and highlights;
  • Font;
  • Density: Compact, Standard or Wide. It changes row heights, gutters and gaps together;
  • Corners: Square, Standard or Rounded, for cards, buttons and stat bars.

If you changed one of these values in Advanced, Basic shows Custom and keeps your value until you pick an option. All settings (Advanced) opens every setting, grouped in sections.

Templates

Templates opens a gallery of 39 finished designs in the General, Competitions and Teams categories, which you can filter by style: Modern, Classic, Futuristic and Aggressive. Every thumbnail is drawn by the real widget. The first one, Base, is the widget's own design with nothing added: plain white, dense and without brand colours. Apply it to go back to that starting point. The Template gallery page lists them all.

  • Apply full design makes the design exactly the template's.
  • Apply, keep my customizations keeps the visual changes you made on top of your current design.
  • Reset to template name goes back to the template after you changed it.
  • Duplicate as personal copies a template to My templates, where you can change it.

A template changes the look only: colours, fonts, corners, spacing, the layout preset and the style of each part. It does not change the widget type, the item it shows, the language, the navigation, the feed settings, odds, affiliate links or compliance.

Built-in templates are improved from time to time. A configuration you saved keeps the design it had. When you open it again, the configurator still shows the name of its template. If that template has changed since, it shows Saved version instead of Template design. If you then change the design, Reset to saved design goes back to what you saved, not to the new version. To use the current version, apply the template again from Templates.

Layout presets

  • Default: a dense list, with separators between rows. Many matches fit on screen.
  • Carded: each competition sits on its own card, with more air between blocks.

Designs made with the older Edge layout keep working.

Toolbar frame and League group frame

Two settings in Livescore layout change the frame of the toolbar and of each competition without changing the rest of the layout preset:

  • Toolbar frame: Integrated (a band across the widget with a line under it), Separate card (its own box, framed like the competition groups) or Transparent (no background and no line).
  • League group frame: Flat (groups run on, with a hairline between competitions), Outlined (the layout's group border, without a shadow) or Carded (each competition on its own rounded card). With the Default layout, groups have no border, so Outlined shows no frame until League group border has a width. With Match layout set to Grid, the matches are cards and League group frame is not available.

Their first entry, for example Default (Integrated) or Layout default (Carded), follows the layout preset and saves nothing. Applying a template resets both. Clicking the toolbar or a competition in Edit in preview opens them.

Header colours

Color treatment sets the background of the headers above a match, team, competition or player:

  • in Match header: Neutral, Accent tint or Dark;
  • in Entity header (teams, competitions and players): Neutral, Accent tint or Entity color, the club or competition colour when the data provides one.

Many templates colour these headers. The window that opens over the widget and the floating cards paint their headers with the same colours, and keep text and buttons readable on them. How the header and its tabs sit inside the window is set by Item window › Header and tabs; see What happens when visitors click.

Match, team, competition and player pages

A page that shows a match, team, competition or player (the Match, League, Team and Player widgets, In-widget content, and the pages of your own site with Dynamic Pages) uses the same header as the window that opens over the widget and as the floating cards: the item's header and its row of tabs are one piece. On a page the header is a little larger, and it adds:

  • a back button at the start of its first row, when the visitor can go back (it replaces the separate back bar);
  • a second line of details: for a match, the full kick-off date, the stadium, the referee and the attendance; for a team, its foundation year and its other competitions; for a competition, its stage; for a player, weight, market value, date of birth and competitions. Search engines and Dynamic Pages can read it too.

On a match page every row of the header shares one centre line: the score, the stats line, the odds and the offer button (on their own row, unless you place the odds with Odds position or the button with the Position in the header of its offer, in Offers), the short responsible-gambling notice right under the odds, the goals and the second line of details. A window expanded to full screen lays out the same way.

The settings of Match header and Entity header apply to that piece:

SettingOn the pageIn the window
FrameHow the header and its tabs sit on the page: Edge to edge, Card with border, Card without border, or Follow layout preset: the card when Sections is Cards, edge to edge when it is Flat, and with Sections on Follow layout preset the card for the Carded layout and edge to edge for Default and Edge.The window has its own: Item window › Header and tabs.
SectionsWhether the sections under the tabs are Flat or Cards; the tab row follows them. This was the second job of the old Frame setting: a header saved as Separate card is now Cards and keeps its card, one saved as Integrated is Flat and stays edge to edge.The same.
Layout (match)Standard: crest, name and score in one line (on a page narrower than 560 px the crest goes above the name). Centered: crest above name at every width. Minimal: a compact header with the status, teams and score only (no stats line, goals, form or second line of details).The same.
Team / League / Player header layoutStandard, or Minimal (no line with the current match, round or season). A value saved as Centered profile shows as Standard.The same.
Color treatmentThe header's colour.The same.
Score displayClean figures, or Solid: each figure in a box, the winner's filled.The same.
Sticky headerA compact row (status, teams, score and star; or mark, name and star) stays at the top of the page once the header scrolls away, below a sticky header of your page and below sticky banners.The window keeps its header in view on its own.
Show headerOff, a match keeps one line with its competition and name, and the TV and star buttons; teams, competitions and players show the tabs only.The same.

The size settings of the old headers drive the page header: Header score and Header team name (560 px and wider), their compact versions (narrower pages), Header score weight, Entity name size and weight, and Entity crest size (24 to 44 px; a larger saved value shows at 44 px). Sticky entity header bg and Sticky entity elevation style the sticky row. Four details of the old match header (the competition label's colour, radius and padding, and the losing score's colour) and Entity header separators no longer apply and are hidden; saved values are kept.

Page title. Embedded on your site, the header adds no heading, so it never competes with your page's own title. A host that asks for one (the titleAs setting, for example h1) gets the match name ("Home vs Away", for screen readers and search engines) or the team, competition or player name as that heading, on pages only, never in the window.

Details & effects

Details & effects, in the Advanced view after Typography, holds the fine details that give a template its character: glows, bevels, gradients, text shadows, and extra colours and sizes for each part of the widget. Every detail a template sets can be changed here, so no look is locked to a template. The settings are grouped in 13 parts:

PartExamples
Corners & shadowsCorner shape (Round or Bevel, cut at 45°), container and dialog radius, shadows.
Weights & italicsThe weight of each text level, and true italic faces.
Toolbar & tab barToolbar text and badges, hover, bevel.
TabsLabel size, weight and spacing; solid tab colours.
Active tab & selectionActive tab colours, gradient, bevel and text shadow; selection glow.
Date stripThe selected day's colours, gradient and bevel.
League groups & rowsPadding, borders and shadows of competition groups.
Match rowsAlternate rows, losing and drawn team text, row buttons.
LiveLive badge, live row tint, gradient and stripe.
Score & statusScore box gradient and bevel, live score colours.
Odds & affiliateOdds cells, labels and stripes; bookmaker logo corners.
Headers & sectionsMatch header gradient and competition label; header scores.
Controls & badgesText on the accent colour, badges, switches.
  • A setting left on Default follows the rest of your design and saves nothing.
  • Applying a template fills these settings with its own values, without marking your design as changed. Switching to another template replaces them.
  • Effects come as named looks (for example Halo, Ring + halo, Underline, Engraved or Embossed) that use your colours. Gradients can be a solid colour, a linear gradient you edit stop by stop, or a ready-made pattern.
  • Corner shape: Bevel needs a recent version of Chrome or Edge. Safari and Firefox show square corners instead.
  • Opacity sliders move in 1 % steps.

Every setting is listed in Configurator options.

Edit in preview

Turn on Edit in preview and click any part of the widget, such as a match row, a score, a tab or a header. The settings column then shows only the settings of that part. Hovering a setting outlines, in the preview, every part it affects. While the mode is on, links in the preview do not open.

Preview width and demo data

The widget adapts to the width of its container, not to the size of the screen. Set Width to the width of the column where it will sit on your site: phone sizes from 320 px, tablet, laptop (1024 px, the default), desktop and wide, or a custom value. Fit scales the preview to the space available without changing its layout.

Demo data replaces live matches with a fixed set of live, finished and upcoming matches, long names and missing logos, so you can check every state at any time of day.

What each part of the configurator covers

SectionMain settings
Global behaviorWidget height, Show all entity headers, Locale (the widget's language) and Compact mode.
DataFeatured leagues and Show only featured leagues. Available on every plan.
LivescoreDefault tab, Date picker mode, Team logos in feed, Team names, Period scores in rows, TV indicator and the Live ticker.
Livescore navigation itemsWhich tabs and toolbar icons appear, the visitors' Odds switch, Live as switch and Tab counters, and Search in list, which narrows the list as visitors type (see Filters and leagues column).
Country and league filters, Leagues columnIn the plan column: a Filters button next to the search in the list, to pick a country or a competition, and the competitions beside the matches, left or right, by feed or as the full list. See Filters and leagues column.
Match behavior / Match tabsDefault tab, the back button, the Odds and TV actions, and a switch per tab.
League behavior, Team behavior, Player behaviorDefault tab, the back button and a switch per tab.
Livescore layoutToolbar frame, League group frame, sticky toolbar and league headers, match row and score styles, Sort feed by.
Item windowHeader and tabs: how the header and its tabs sit in the window that opens over the widget (pages use Frame in Match header and Entity header).
OffersYour own bonus offers, in the plan column. See Your own offers.
Entity headersThe header above match, competition, team and player views. Showing or hiding it and Divider under header also apply to the window that opens over the widget; with the header hidden, the window keeps a slim bar with its buttons. Floating cards always show their own header.
ComponentsThe style of each part: toolbar, match rows, headers, tabs, standings and other data blocks. Pages, the window and floating cards share one header; see Match, team, competition and player pages.
Colours, radius, density, typography, Details & effectsFine-grained design, usually set by a template.

Some labels follow the widget you select: with Match selected, for example, the Entity navigation section is called Match navigation.

Team names

Team names (for match rows) and Match header team names offer Auto (fit to space), Full name, Shortened name and Team code (ATL).

  • Auto shows the full names, on two lines when needed, like Full name. In match rows, the official team codes (ATL, NYC) replace them only on very narrow widgets (rows of 489 px or less), and then for the whole list at once. In the match header, both teams of a match switch to their codes only when a name would still be cut.
  • Shortened name drops FC, CF, SC and similar. It is also used when a team has no code.
  • Team code always shows the official code.

The full name is always available on hover and to screen readers.

Widget height

Leave Widget height at 0 and the widget grows with its content, so your page scrolls. Set a height and the widget scrolls inside itself; its toolbar and competition headers then stick inside the widget.

Live ticker and events log

Live ticker & events log (Pro and Ultra) adds a score bar of matches Above the feed or Below the feed, and a log of the events you tick (goals, cards, kick-offs, results...) as a side card or a strip. Choose which matches the bar shows (featured leagues, all matches or each reader's favourites, and live, upcoming or finished), with Team codes or Short names, the competition's logo, and how it moves (Motion: off, continuous, one match or a full strip at a time). Keep ticker visible keeps the bar on screen while visitors scroll. See Ticker and events log.

Undo and saving

Undo and Redo sit at the top of the settings column. Your edits stay in the editor until you save: in the admin, Save and apply (or Save configuration) puts them live, and Reload saved throws away unsaved edits. See Domains, configurations and saving.

Moving a design

  • In the public playground, Export design and Import design… move the look only. Use them to bring a design you tried in the playground into your account.
  • A design exported from an older version of the editor is updated when the playground imports it: settings that older versions stored as fixed values follow today's design again. A note at the top of the settings, Updated to the current version — review and save, lists them under What changed, and Keep previous look brings back the earlier look. Colors, fonts, language, sections and plan features are never changed.
  • In the admin, Export configuration downloads or copies the whole configuration, and Import JSON in the Configurations tab loads one into the editor. Before an import changes anything, a review lists what will be applied and what your plan will ignore.

On this page