Integration

Add “Play as Puzzle” to your site

Add a puzzle option next to the media you already publish. Players follow a normal link to a puzzle page; no iframe is required.

Example: Content Page

Video Player

Watch
Plays the video normally on your site

Play as Puzzle
Opens the same media as an interactive puzzle

You are not replacing anything

Keep your existing player, layout, and workflow. Just add a new button or link alongside your current actions.

Standard link integration

Add a link like this wherever you want puzzle play to appear. In production, use your puzzle subdomain, such as https://puzzles.yoursite.com.

<a href="https://puzzles.yoursite.com/play?client_id=YOUR_CLIENT_ID&media_url=MEDIA_URL">
  Play as Puzzle
</a>

Create puzzles.yoursite.com as a CNAME to puzzlebaddie.com. Keep your normal watch page on your own site, and send only puzzle play traffic to the puzzle subdomain.

When building this link yourself, URL encode the full media_url value. For example, https://yourwebsite.com/video.mp4?clip=123&size=large should be placed in the puzzle link as https%3A%2F%2Fyourwebsite.com%2Fvideo.mp4%3Fclip%3D123%26size%3Dlarge. The link builder on the Partner Dashboard will do this encoding for you.

Link protection options

Start with Standard links for the simplest integration. High Security and Ultimate Security are available when your site is ready to generate signed links on the server.

Standard

Fastest setup and recommended starting point for most integrations.

High Security

Shared-key signing with HMAC-SHA256 and a generated shared secret.

Ultimate Security

Public-key signing with Ed25519, where the private key stays only on your server.

Signed links should be generated server-side. Keep shared secrets and private keys out of browser JavaScript. Expiring signed links will include parameters such as expires, key_id, and sig. Learn more about signing and expiry.

1. Add a media source

2. Configure the puzzle host

Create a CNAME such as puzzles.yoursite.com

3. Add the link

Place the puzzle link next to Watch or other actions

Start adding puzzle links

Start Free