Level 10 / 50 XP0day streak0TicketsPlay
Pro

Sportsdle for Partners

Embed docs

One box and one script put a daily “guess the player” game on your page. Build yours on sportsdle.com/partners, get a free key for stats on your dashboard.

The code

<div data-sportsdle="classic" data-sport="nhl" data-key="pk_your_key" data-theme="auto" data-lang="en"></div>
<script src="https://www.sportsdle.com/embed.js"></script>
  • Put the script right after the box, without async or defer. It reserves the game's height before anything below is painted, so your page never jumps. It weighs about 3 kB and is cached for an hour.
  • Several games on one page: one box each, one script is enough (pasting it twice does no harm).
  • The game itself loads when a reader scrolls near it, and grows as the reader guesses.
  • Content added after the page loaded (a single-page app, infinite scroll): call window.Sportsdle.scan() once the new box is in the page.

Options

AttributeValuesWhat it does
data-sportsdle"classic"The game. Guess the player is the one offered today.
data-sport"nhl" · "nfl" · "cfb"Hockey, pro football or college football.
data-key"pk_…"Optional. Your free key, for your stats (from your dashboard).
data-theme"auto" · "light" · "dark"Auto follows the reader's device setting. Default: auto.
data-lang"en" · "fr"Every word of the game, clues included. Default: en.
data-titleany textOptional. The iframe's title, read by screen readers.

A value we do not know falls back to its default: a typo never blanks your page.

Without a script

If your editor strips scripts, paste the iframe alone. It keeps a fixed height (the page scrolls inside it after a few guesses) and sends no events.

<iframe src="https://www.sportsdle.com/embed/nhl/classic?theme=auto&lang=en" title="Sportsdle daily game" style="width:100%;height:760px;border:0" loading="lazy" allow="clipboard-write; web-share"></iframe>

Events for your analytics

The loader re-sends the game's moments as DOM events on the box (they bubble up to the document). Each event.detail carries sport, game and puzzleDate, plus the fields below. Nothing in them is about the reader.

EventWhenExtra fields
sportsdle:readyThe game is on screen.—
sportsdle:game_startThe reader made a first guess.—
sportsdle:guessEach guess.guess (1–10), correct (true/false)
sportsdle:game_endFound or out of guesses.won (true/false), guesses
sportsdle:shareThe reader shared the result.—
sportsdle:clickoutThe reader followed a link to Sportsdle.—

To count finished games in Google Analytics 4:

document.addEventListener('sportsdle:game_end', function (event) {
  gtag('event', 'sportsdle_game_end', {
    sport: event.detail.sport,
    won: event.detail.won,
    guesses: event.detail.guesses,
  });
});

Your CMS

WordPress

Add a Custom HTML block and paste the code. On WordPress.com plans that do not allow scripts, paste the iframe version instead.

Ghost

Add an HTML card and paste the code.

Squarespace

Add a Code block (on a plan that allows JavaScript) and paste the code.

Wix

Wix places embedded code inside a frame of its own, which the game cannot resize: use Embed HTML with the iframe version and give the element a height of about 760 px.

Webflow

Add an Embed element and paste the code.

Newsletters

Email clients run no games. Link to the page where the game lives; a hosted page and a daily image for newsletters come with the paid plans.

If your site has a security policy

If your pages send a Content-Security-Policy header, allow our domain:

frame-src https://www.sportsdle.com;
script-src https://www.sportsdle.com;

Privacy

The game sets no cookie, shows no ad and loads nothing but Sportsdle (its own security policy blocks everything else). A game in progress is saved in the reader's browser (keys starting with sdle_embed_), on your site only. We count anonymous daily totals per key and per site for your stats; no identifier, no IP address is stored with them.

Versions

embed.js is version 1. Its attributes and events keep working for at least 12 months after any version that replaces them, and a version that would break your code ships at a new address. See the partner terms.

  • November 2026: version 1. Hockey, pro football and college football; English and French.

Data

Pro football: nflverse (CC BY 4.0). College football: CollegeFootballData.com. Hockey: public player records. Each game credits its source under the board.

Questions: contact@sportsdle.com.