Your own offers
Show your own bonus offers and partner buttons inside the widget, as a list, a grid, a card, a strip, a CTA banner, a button next to the odds or a text link, rotate them, and pin them while readers scroll.
Plans
Offers shows your own bonus offers inside the widget: a sign-up bonus, an enhanced price, a free bet, or simply a button to your partner next to the odds of each match. You write each offer once, choose where it appears (one place or several) and how it looks, and the widget shows each visitor the offers meant for their country and device. You find it in the Offers section of the right-hand column of the configurator.
Your affiliate links are offers too: a Button offer in the match rows, the match header and the floating card. Banners stay separate.
How it works
The Offers section has three tabs:
- Offers (N): your offer library. Each offer has a brand, the offer itself, a button and its terms.
- Placements (N): where offers appear, in which format and style.
- Settings: switches that apply to every offer.
Every change shows in the preview at once. Add offer first asks what you are adding (see Kinds of offer) and places it where that kind usually goes: an offer list or a CTA banner Above the matches, a strip in the Match window footer, a button in the Match rows, a text link Below the odds. Its Where it shows box adds more places: one offer can show in several of them. Change or remove them in Placements.
Sample offers in the public playground
The public playground starts with three offers marked (SAMPLE). They link to the SoccersAPI plans page, carry a Sample tag in the editor and are never exported. Add offer adds yours next to them.
Kinds of offer
| Kind | Group | What it is |
|---|---|---|
| Offer list | Block | Brand, offer and terms, in a list of offers. |
| Offer card | Block | One offer with logo, terms and button. |
| Strip | Block | One slim line. The match window footer. |
| CTA banner | Block | A wide banner on your brand colour (or an image or gradient): headline, sub-text, button, promo code and terms. |
| Button | Inline | Your logo and a short label (Button text, up to 18 characters), next to the odds of each match, in the match header and in the floating card. |
| Text link | Inline | One sentence with your brand linked (Sentence, {brand} becomes the link), below the odds. Without a sentence: "Bet on this match at brand", in the widget language. |
Blocks have their own space; inline offers sit inside rows, headers and the odds. The kind is only where the editor starts: the place decides how the offer looks. A Button offer can also go in a strip, a card or a list if you pick it there, and a list offer can be a button in the match rows.
Formats
| Format | What visitors see |
|---|---|
| Offer list, layout List | Rows, one per offer: logo, brand, the offer, the button and the key terms underneath. |
| Offer list, layout Grid | Tiles side by side while they fit (each tile needs about 220 px). When the tiles no longer fit side by side, on phones for example, they stack as compact rows. |
| Offer card | One offer, larger, with an optional background gradient or image. It can rotate through several offers. |
| Strip | One line: logo, brand, the offer, the Advertising label with the age chip, and the button. An offer with a Headline adds its terms underneath. With more than one offer, +N opens the others (see The strip and +N); it can also rotate. |
| CTA banner | The offer large, on its brand colour: brand, badge and the Advertising label, the headline, the sub-text, a big button with the promo code, and the terms and responsible-gambling line underneath. With a Card background (gradient or image) it sits on that instead. It can rotate; pinned, it folds into the bar. |
| Button | See Inline places. |
| Text link | See Inline places. |
A list shows offers that have a Headline. An offer without one is a brand placement: it appears in offer cards, strips and the pinned bar, not in lists.
For lists you also choose:
- Density: Compact or Comfortable;
- Offers shown: 1 to 5 (default 3), and how many to show when the widget is narrower than 560 px (Below 560 px) or, for a grid, When tiles stack (default 2);
- Title, shown above the list (default: "Offers", in the widget language), and an optional See all link with its own label.
Placements
| Placement (Where) | Formats | Pin while scrolling |
|---|---|---|
| Above the matches | List, card, strip, CTA banner | Yes |
| Top of the widget (banner zone) | List, card, strip, CTA banner | Yes |
| Between leagues (after the third competition) | List | No |
| Bottom of the widget (banner zone) | List, card, strip, CTA banner | No |
| Item pages, top (banner zone) | List, card, strip, CTA banner | No |
| Item pages, bottom (banner zone) | List, card, strip, CTA banner | No |
| Match window, Prematch tab | Card | No |
| Match window footer | Strip | No |
Item pages are the match, team, competition and player views that open inside the Livescore with the In-widget content navigation mode. Between leagues goes after the third competition of the list, not counting the favourites group, so it needs at least three competitions; it does not appear when Match layout is Grid. The Match window, Prematch tab card spans the row under Best odds while the match's Prematch tab is open in the match window (not in floating cards, and not on item pages). The Match window footer is the bottom of the window that opens over the widget; it is always in view, above the Modal bottom banner when you have one (both show). Blocks never appear in floating cards; a Button can (see Inline places).
In Placements, each placement is one line (where, format, style, pin and rotation): click it to edit. Below them, More places lists every place you are not using yet, with a line on where it shows; click one to add it. A new placement opens ready to edit.
To keep the widget readable:
- One commercial element per banner zone. An offer in one of the four places marked banner zone takes the place of the banner in that zone. If the offer has nothing for a visitor (no offer for their country, for example), the banner shows instead.
- The match window footer shows both. The strip sits above the Modal bottom banner; neither replaces the other. The window's content ends where the footer starts, so nothing is covered. The strip follows the window's header: a card with the same edge and corners where the header is a card, edge to edge where the header is.
- At most two units on the same screen. The top banner counts as one while it is shown. In the match window on a phone, only one: the Prematch tab card while that tab is open, the strip on the other tabs.
- A brand never repeats on the page. When two units could show the same brand, the placement that comes first in this order keeps it: Above the matches, Top of the widget, Item pages, top, Between leagues, Bottom of the widget, Item pages, bottom. The match window counts apart (the Prematch tab card first, then the strip): it can show a brand that is also on the page. A unit that rotates keeps every offer it shows in turn, so a placement after it may have none left. A strip that does not rotate keeps only the offer it shows; its +N leaves out brands already on screen.
- One unit per placement. If two placements point to the same place, the first one switched on is used.
- "All offers" in a block means your block offers. A list, card, strip or CTA banner set to All offers leaves buttons and text links out; pick them under Offers to show them there too.
Inline places
| Place | Kinds | Where visitors see it |
|---|---|---|
| Match rows | Button, text link | Next to the odds of each match in the livescore list. Never in team or competition fixture lists, head-to-head lists or favourites. |
| Match header and window | Button, text link | In the match header, in the header of the window that opens over the widget and, on tablets, above the tabs of a pinned match. |
| Below the odds | Text link, button | Under the odds in the match's Odds tab. |
| Floating match card | Button | In a floating match card (widgets 900 px wide or more), next to the live stats. |
Inline places follow their own rules:
- One brand per place. A row shows one button, never two.
- One brand per match (Brand: One brand per match, the default). Each match keeps its brand for the whole visit, and it is the same brand in its row, its header, its window and its floating card whenever those places carry that brand. Matches share your brands by each offer's Weight. Same brand everywhere (per visit) shows one brand in every row; Rotate every few seconds steps through them (10 to 300 seconds).
- Outside the block rules. Inline places never count towards your placements or the two units per screen, and the same brand can show in many rows.
- Quiet rows. In the match rows a button looks like the odds (Look: Like the odds, the default): your logo, your brand name and the short label on wide rows; the logo and the label on large phones and small tablets; and the logo alone on most phones (rows under 400 px wide), where an offer without a logo shows the first letter of its brand. A button with only a label, like an affiliate link, is as wide as the longest label of your buttons; on most phones a label longer than about six characters is shortened so the odds keep their room. The column has the same width in every row so the odds stay aligned. A row without a button (see Which rows) keeps the empty column. Brand colour and Outline are there if you want them.
- Brand colour in the header. In the match header, the window and the floating card the button takes your Brand colour (or the template's button colour without one).
- Declared as advertising. When the match rows show buttons, the short responsible-gambling line above the first competition starts with Ad (in the widget language), and so does the line under the match header when it shows a button. Where there is no notice to show (you turned it off, or the visitor's country has no notice text), the line shows Ad alone, and only while buttons are shown. Each button's accessible name ends with "(ad)".
- Your compliance policy. Gambling offers in inline places always obey Disable affiliate links for the visitor's country, exactly as affiliate links did, whatever Apply my compliance policy to offers says.
Each inline place has, in Placements:
| Setting | Values |
|---|---|
| Position in the row (match rows) | Next to the odds (in their place when a match has none), Under the status, Own line under the teams. |
| Position in the header (match header) | Default (centred in the match header, at the end of the window header), Left, Center, Right. Left and right swap in right-to-left languages. |
| Brand | One brand per match, Same brand everywhere (per visit), Rotate every few seconds. |
| Which rows (match rows) | All rows, Only rows with odds, Only some competitions (competition ids). |
| Look (buttons) | Like the odds (quiet), Brand colour, Outline. |
Your affiliate links are offers
Plans
You add and edit affiliate links in Offers, as Button or Text link offers. The configurator no longer has a separate Pro affiliate links section, and the position of the button in a match row is the Position in the row of the Match rows place.
The affiliate links of a configuration saved before (the 20 link slots of that former section) show as Button offers, in the same places as before: the match rows if Show in match rows was on, and the match header, the window and the floating card if Show in match header was on. In the match rows they look like the odds.
The first time the configurator in the admin opens a configuration that still has affiliate links, it turns them into offers of your library and says so at the top of Offers, for example "2 affiliate links are now Button offers.", with a reminder to add the brand name and logo and to pick more places in Where it shows. Your widget looks the same as before. When you save, the offers take the place of the links, and from then on you edit them in Offers only.
The conversion is all or nothing. If some links cannot be carried over intact, the admin keeps your links as they were instead of saving part of them, and may show a message that ends "The previous configuration was kept." (see Troubleshooting).
Each setting of a link carries over:
| Affiliate link | Offer |
|---|---|
| Label | Button text and button label, and the brand name until you write it |
| URL | Link (kept as it is, http:// included) |
| Description of a Text link | Sentence |
| Type: Text or Button style: Text link | A Text link offer |
| Color | Brand colour (the theme shortcuts keep following your theme) |
| Weight | Weight, in proportion |
| Target countries / Restricted countries | Only in… (target countries minus restricted ones) / Everywhere except… |
| Restricted devices | Devices |
| Show in match rows + Bet link placement | Match rows place with its Position in the row |
| Show in match header + Affiliate button position | Match header and window place with its Position in the header, and Floating match card |
| Rotate links + Rotation interval | Brand: Rotate every few seconds, with your interval |
| Rotate links off | Brand: Same brand everywhere (per visit), as before |
| Start strategy | First: library order; Session hash or Random: by weight |
| A switched-off link | A switched-off offer |
Size, Content, Icon, Custom CSS classes, Target and Advance on click have no equivalent: buttons have one look and always open in a new tab.
Style and colours
Each placement has a Style:
- Follow cards: the unit takes the look of the cards around it, so it reads as part of the widget. In the match list it follows your competition groups: rounded card, contained or flat (no frame, with the same divider as the groups). In the match window and on item pages it follows the section cards. The strip in the window footer is a card where the window's header is one (Carded layouts) and runs edge to edge where the header does (flat templates, and phones);
- Bordered: an outline in your accent colour and an outlined button, on your card surface;
- Solid: the unit filled with your accent colour.
Under Colours you can override eight colours, separately for the light and the dark theme: Background, Text 1 (primary), Text 2 (secondary), Border, Button background, Button text, Badge background and Badge text. If you set a background without its text colour, the widget picks a readable text colour for it. The editor warns when a pair you chose is below a 4.5:1 contrast.
Each offer can also have a Brand colour. It paints the plate behind the logo, a thin top edge on grid tiles and on the offer card, the CTA banner and the button in the match header and window. The Theme accent, Success, Danger and Warning shortcuts follow your theme.
Offer card background
An Offer card and a CTA banner can have a Card background:
- Gradient: a gradient per theme, edited like the other gradients of the configurator. The editor warns when your text does not stay readable where the gradient is weakest.
- Image: an
https://image. Use a dark, low-detail image: the text sits on top of it, over a dark layer.
Featured offer and badge
- Tick Featured on one offer to highlight it. It carries a Top offer label (in the widget language) and leads the pinned bar. Only one offer can be featured at a time.
- Badge adds a short label of your own to an offer, such as Exclusive (up to 16 characters).
- Promo code shows the code with a copy button.
Pin while scrolling
Plans
Pin while scrolling keeps a compact bar on screen after the reader has seen the unit and scrolled past it. It is offered on Above the matches and Top of the widget (banner zone), at the Top or the Bottom edge.
- An offer card, a strip and a grid that fits on one row pin as they are.
- A list, or a grid that wraps, pins as a bar with the featured offer (or the first one) and +N offers, which opens the full list.
- The bar shows the brand, a Visit button, the Advertising label with the age chip, and the responsible-gambling line. It never covers the unit while the unit is back in view.
- Readers can hide the bar with its close button. It stays hidden for the rest of their visit.
- A sticky banner keeps its edge: if your top banner is sticky, offers can only pin to the bottom, and the other way round.
- Floating cards keep the bottom edge: while an item is pinned, offers do not pin to the bottom.
The other placements do not pin: item pages have their own sticky header, and the match window footer is always in view.
The strip and +N
A strip shows one offer. When it has more (all offers, or the ones you picked), a +N button at its end opens the others as list rows, with the responsible-gambling line. In the match window the list opens upwards: the window's content gets shorter, nothing is covered. Hide offers, or the Esc key, closes it again without closing the window.
Rotate offers
Where one offer shows at a time, Rotate offers can step through several: the Offer card, the Strip, and the pinned bar of a list (Rotate the pinned bar). Choose Off (one offer stays), the default, or Every 4 to Every 30 seconds.
- The next offer slides up from the bottom over the current one. Visitors who ask their system to reduce motion get a short fade instead.
- It waits while the visitor points at the unit, focuses it, or opens the strip's +N list, while the unit is off screen and while the browser tab is hidden. After a pause the full interval starts again.
- A pause button sits on the unit while it rotates. The pinned bar has its close button instead.
- The unit keeps the height of its tallest offer, so the page never jumps.
- Each offer shown counts as its own impression (see Events).
- Rotation follows the Order of Settings. It needs at least two offers in the placement; the editor tells you when there is only one.
Writing an offer
| Field | What it does |
|---|---|
| Brand name, Logo URL, Brand colour | Who the offer is from. The logo must be an https:// image; without one, the brand's initial shows. |
| Headline (the offer) | The offer itself, up to 60 characters, for example Bet 10, get 30 in free bets. |
| Badge, Promo code | Optional extras (see above). |
| Category | Gambling or Other. Compliance rules (below) only hide gambling offers. |
| Featured | Highlight this offer (see above). |
| Label, Link | The button. The link must start with https://; an offer without a valid link is not shown (a converted affiliate link keeps its http:// link). An empty label reads "Get offer" in the widget language. |
| Button text (Button), Sentence (Text link), Sub-text (CTA banner) | The texts of the new kinds. A button's offer texts (headline, badge…) are optional: they only show if the offer also goes in a list, a card or a CTA banner. |
| Terms line, T&Cs link | The key terms, up to 250 characters. They wrap and are never cut. |
| New customers only | Adds that line to the terms. |
| Minimum age | Inherit (visitor country), or 18+ to 21+. The age chip shows it. |
| Operator legal name, Licence | Shown under the offer to visitors in Spain, Mexico and Colombia, in lists, offer cards and the pinned bar. Strips have no operator line. |
| Countries | Everywhere, Only in… or Everywhere except…, with two-letter country codes such as GB, IE. |
| Country unknown | With Only in…: Hide the offer or Show the offer when the visitor's country cannot be detected. A new offer starts on Show the offer, and the editor warns about it until you pick Hide the offer. With Everywhere except… the offer shows when the country cannot be detected. |
| Devices | Desktop, mobile or both. |
| Show until (optional) | An end date. The offer stops showing at the start of that day (00:00 UTC), so pick the day after its last day. |
Use the arrows to change the order of your offers, and the buttons next to each offer to duplicate or delete it.
Every offer link opens in a new tab with rel="sponsored noopener". Only
https:// links are shown. The offer frame (title, labels, buttons) follows
the widget language. Your own texts (brand, offer, terms) are shown as you
wrote them, in their own reading direction, also in an Arabic or Persian
widget.
Settings
| Setting | What it does |
|---|---|
| Offers on | Main switch for every offer and placement. |
| Advertising label | The Advertising label on each unit. Most markets require ads to be labelled; the age chip stays when you turn it off. |
| Order | Manual (library order), Shuffle on each visit or By weight on each visit (each offer then has a Weight, 1 to 100). The order is drawn once each time the page loads. Placements set to rotate step through it, one offer at a time. Inline places always share brands by Weight, so the weight shows as soon as you use one. |
| Keep the first offer first | On by default. With shuffle or weight, the first offer of your library always leads and only the others change order. |
| Apply my compliance policy to offers | Automatic, On or Off. See below. |
Plans and limits
Plans
| Pro | Ultra | |
|---|---|---|
| Offers in your library, affiliate links included | 15 | 70 |
| Block placements switched on at once | 4 | All of them |
| Inline places | All four | All four |
The allowance includes your affiliate links, so converting them never leaves you short. The editor shows how many you use, for example 3 / 15 offers and 2 of 4 placements on. Only placements switched on count, and inline places never do: when all the placements your plan includes are on, a new one is added switched off.
Offers above your limit are not shown, and placements above it are switched off. If you save on Pro or Ultra while above the limit (after moving from Ultra to Pro, for example), the offers above it are removed and those placements are saved switched off. Free and Starter cannot add offers. Custom plans agree their limits with SoccersAPI.
Your markets, your rules
You manage the regulation of your offers in each market. The widget gives you tools; it does not decide what is legal where you advertise.
- Warnings, never blocks. The editor points out common problems: a missing brand or button link, an offer with no terms, "risk-free" wording, words such as "free" or "bonus" where they are restricted, pinning in Spain, or an offer visible in a country that your own policy restricts. Under Review, it lists markets with special rules where the offer can be seen. They are reminders to check, not legal advice, and you can always save.
- Targeting per offer: countries, devices, unknown country and an end date (see Writing an offer).
- Disclosure: the Advertising label, the age chip, the terms, the operator line in Spain, Mexico and Colombia, and a responsible-gambling line with a help link taken from the visitor's country, as in the widget's notice. Strips carry the label, the age chip and the terms only: the operator and responsible-gambling lines appear in lists, offer cards and the pinned bar.
- Your compliance policy. With Apply my compliance policy to offers on, gambling offers are hidden wherever your compliance policy switches off affiliate links or commercial banners: in the countries you restrict, everywhere in Clean mode, everywhere when you turn on Disable affiliate links or Disable commercial banners, and for visitors whose country cannot be detected when you restrict countries or set a site jurisdiction (unless you turn off Block betting when country is unknown). Automatic (the default) is on as soon as you have declared such a policy, and off otherwise. Offers in the Other category are never hidden by it.
- A policy agreed in your contract with SoccersAPI always applies to gambling offers, even with the setting Off.
Events for your analytics
The widget tells your page when an offer is seen and clicked, with the
ls:offer-impression and ls:offer-click events. An impression counts when at
least half of the unit has been on screen for one second, once per offer and
placement while the page is open. Only offers on view count: in a rotating
unit each offer counts when its turn comes, and a strip's other offers count
when the visitor opens +N. The widget does not count them for you:
send them to your own analytics. See Events for developers.
Buttons and text links in inline places send the same events, with the match
in matchId: an impression once per place, offer and match (a row counts
when it has been half on screen for one second, not on every update of the
list).
Events need the script installation of paid plans, which offers need anyway.
If an offer does not show
- Offers on is off, or the placement is switched off or above your plan's limit.
- The offer has no Brand name, or its button Link is missing or does
not start with
https://. - A list only shows offers with a Headline.
- The offer is limited to other countries or devices, its Show until day has started, or the visitor's country is unknown and the offer hides in that case.
- Between leagues needs at least three competitions in the list and does not appear with Match layout set to Grid.
- Another unit already uses the two places on screen, or the same brand is already shown elsewhere on screen. On a phone, the match window shows one unit: on the Prematch tab, the Prematch card.
- Your compliance policy hides gambling offers for that visitor.
- A Button or a Text link set to All offers is not in your lists, cards, strips or CTA banners: pick it under Offers there.
- Inline places: the row is in a team or competition fixture list (buttons only show in the livescore list), Which rows leaves it out, or Disable affiliate links applies to the visitor's country.
Odds, affiliate links and banners
Earn from your widget with bookmaker odds, your affiliate buttons and bonus offers, banner slots, and put your logo on it.
Betting content and responsible gambling
The notice every widget shows, and how to hide odds, bookmakers, affiliate links and banners where you must.