Newsroom Puzzles

Setup

Getting Started

Add a puzzle widget to your site in under five minutes — one script tag, no account required.

Newsroom Puzzles loads with a single script tag. No API keys, no signup, no backend changes on your side. This guide walks through install, verification, and finding your private stats link.

1. Get your embed code

Go to the homepage install section and enter your site domain (e.g. yourpaper.com). Choose a game, then copy the snippet. 

<script src="https://newsroompuzzles.com/embed.js?site=yourpaper.com&game=sudoku"></script>

Replace yourpaper.com with your actual domain. The site parameter is how we separate your analytics from other publishers — use the domain readers see in the browser bar.

2. Paste it on a page

Drop the script tag anywhere in your page HTML. The widget mounts right after the script and renders inside a self-contained container — no iframe, no extra div required.

Common placements:

  • 404 error pages — give readers something to do while they find their way back
  • Games or lifestyle sections — a daily puzzle without sending traffic off-site
  • Sidebars — compact engagement on article pages

3. Verify it works

Load the page in a browser and confirm:

  • The puzzle appears below where you pasted the script
  • You can interact with the grid (play a move, flip a card, etc.)
  • A small “Powered by Newsroom Puzzles” link appears at the bottom of the widget

The widget uses Shadow DOM to isolate its styles from your site’s CSS. Try every game in the gallery before going live.

4. Find your stats link

After the widget loads at least once on your domain, we create a private stats page for you. Enter your domain on the homepage and your stats URL will appear below the embed code — or see an example stats dashboard.

Script parameters

Parameter Required Description
site Yes Your domain for analytics (e.g. yourpaper.com)
game No sudoku, akari, wordsearch, hangman, memory, game2048
pack No Word list for wordsearch / hangman — general, sports, newsroom, etc.
theme No light (default) or dark
accent No Hex color for buttons and highlights (e.g. %231e3a5f)
flat No flat=1 — flush embed inside your layout card

What’s next?

Pick the guide for your platform: