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
asyncordefer. 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
| Attribute | Values | What 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-title | any text | Optional. 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.
| Event | When | Extra fields |
|---|---|---|
sportsdle:ready | The game is on screen. | — |
sportsdle:game_start | The reader made a first guess. | — |
sportsdle:guess | Each guess. | guess (1–10), correct (true/false) |
sportsdle:game_end | Found or out of guesses. | won (true/false), guesses |
sportsdle:share | The reader shared the result. | — |
sportsdle:clickout | The 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.
