Put it on your site
Embed a contest on your website
Show your contest on any website: your blog, portfolio, link-in-bio page or online shop. Copy two snippets, paste them in, and you're live.
You can show the contest two ways:
Embedded
The widget renders in place, where you put the tag. Great for a dedicated giveaway page or a section of your homepage.
Modal
A launch button renders where you put the tag and opens the widget over the page. Great for dropping into existing pages.
Get your embed code
- Open the Widget Builder. In your dashboard sidebar, go to Stylization → Widget Builder.
- Click Add to site. It's in the top bar, and opens the Add the widget to your site dialog.
- Pick the contest. Choose it under Contest. Only live contests are listed.
- Choose how to show it. Under Show as, pick Embedded or Modal.
- Copy both snippets. Use the Copy buttons next to each one.
You can also get the same two snippets from the share dialog: after you create a contest, or from Share on a contest, open Integrate with your site. It starts closed, and the contest is already chosen for you.
Someone else builds your site? Click Send to a developer in that section, enter their email and add a note if you like. They get both snippets (Embedded and Modal) and a link to this guide, and their replies come straight to you.

The two snippets
1. Add the SDK script. It's the same for everyone and loads the widget. Add it once per page, either in your page's <head> or just before </body>:
<script src="https://cdn.winzos.io/sdk/winzos-sdk.js" async></script>2. Add the widget mount point. Put this exactly where you want the widget (or the launch button) to appear. Yours will have your own contest ID, the long code the Add the widget to your site dialog fills in:
<div data-winzos-contest="3f2b8c1e-9a4d-4e7b-b1c2-5d6e7f8a9b0c" data-winzos-presentation="inline"></div>| Attribute | What it does |
|---|---|
data-winzos-contest | Which contest to show, by its contest ID. The widget uses the styling you saved in the Widget Builder. |
data-winzos-presentation | inline for Embedded, modal for Modal. |
data-winzos-max-height | Optional, Embedded only. The tallest the widget may grow, in pixels, such as 640. See Keep the widget a set height. |
Any other data-winzos-meta-* attribute passes a value of yours through to your postbacks: data-winzos-meta-click-id="cmp-1" comes back as custom.click_id when that visitor signs up or completes an action. See Pass your own values through.
Added the widget before November 2026?
Older mount points name the contest with a short number, often with data-winzos-creator beside it, like data-winzos-contest="123" data-winzos-creator="456". They no longer load. Open Add to site again, copy the new mount point, and replace the old one on your page. The script tag stays the same.
Your browser's developer console names an old mount point and gives the same fix.
Optional: open the modal automatically
Want the contest to pop up as soon as someone lands on the page? Add data-winzos-open="true" to a modal mount point:
<div data-winzos-contest="3f2b8c1e-9a4d-4e7b-b1c2-5d6e7f8a9b0c" data-winzos-presentation="modal" data-winzos-open="true"></div>Visitors can still close it, and the launch button stays on the page so they can reopen it.
Optional: keep the widget a set height
An embedded widget grows with what it shows, so a game with many steps can make your page much longer. To cap it, add data-winzos-max-height with a height in pixels to an Embedded mount point:
<div data-winzos-contest="3f2b8c1e-9a4d-4e7b-b1c2-5d6e7f8a9b0c" data-winzos-presentation="inline" data-winzos-max-height="640"></div>The widget then never grows past that height and scrolls inside itself, with Start now kept in view at its bottom. You can set the same limit without touching the code in the Widget Builder: Widget → Style → Max height (embedded). If both are set, the one on the page wins. Leave both out and the widget grows as it needs to.
Where to paste it
Most website builders have a block for custom code. Look for one called Custom HTML, Embed or Code:
- WordPress: add a Custom HTML block.
- Squarespace: add a Code block.
- Webflow: add an Embed element.
- Hand-coded sites: paste straight into your HTML.
You can paste both snippets into the same block. If your builder has a site-wide "header code" setting, you can put the script there once and use just the <div> on each page.
Some builders put custom code inside a small sandboxed frame. If the modal looks cramped there, switch to Embedded, or put the script in the site-wide header code instead.
Running more than one contest? Add a <div> for each. One script tag covers them all.
No website? Share the link
Every contest has its own page on app.winzos.io. Grab the link from Share in your contest's menu (see Manage your contests) and post it anywhere: your bio, stories, videos, newsletter or community.
What's next?
Customize the widget so it looks right at home on your site.