Embed
Beyond sharing a link, you can embed a quiz directly into your own website — visitors complete it on your landing page without leaving.
Three embed modes
Open Share → Embed on the target quiz, pick a display mode, then copy the generated code into your site's HTML.
| Mode | Best for | Behavior |
|---|---|---|
| Inline (auto height) | Blending into the page content flow | Height follows the content automatically. Recommended |
| Popup | A call-to-action button on your page | Opens the quiz in a full-screen overlay |
| Plain iframe (fixed height) | Environments where loading a script is not an option | Simplest; fixed height with inner scrolling |
Inline (auto height)
<div data-rooquiz-embed data-rooquiz-token="YOUR_QUIZ_TOKEN"></div>
<script src="https://YOUR_QUIZ_DOMAIN/embed.js" async></script>The embed script watches the quiz content height (pagination, navigating to the result page, etc.) and resizes the iframe in real time — no scrollbars, no clipping.
Popup
<div data-rooquiz-embed data-rooquiz-token="YOUR_QUIZ_TOKEN" data-rooquiz-mode="popup" data-rooquiz-text="Start the quiz"></div>
<script src="https://YOUR_QUIZ_DOMAIN/embed.js" async></script>A button is rendered on your page; clicking it opens the quiz in a full-screen overlay. Close with ESC or by clicking the mask.
Plain iframe
<iframe src="https://YOUR_QUIZ_DOMAIN/a/YOUR_QUIZ_TOKEN?embed=1" width="100%" height="600" style="border:0;" title="RooQuiz"></iframe>The iframe always points at the quiz's stable /a/<token> address, not its custom path, so changing the custom path later never breaks embed code that's already on your site.
The "Made with RooQuiz" line
On the Free plan, embeds keep a small Made with RooQuiz credit line. It sits outside the iframe, on your page: inline and popup embeds render it automatically through embed.js, and the plain iframe code includes it as a <p> right below the iframe — keep it there. On Pro, the generated code leaves it out.
Available attributes
| Attribute | Description |
|---|---|
data-rooquiz-token | Required. The quiz public token |
data-rooquiz-mode | inline (default) or popup |
data-rooquiz-utm-source | UTM source recorded with every response, used by UTM Source Tracking and the source breakdown in Insights |
data-rooquiz-utm-medium | UTM medium (optional) |
data-rooquiz-utm-campaign | UTM campaign (optional) |
data-rooquiz-height | Initial height (px) for inline mode, used before auto-resize kicks in |
data-rooquiz-text | Button label for popup mode |
If you don't set the UTM attributes, any utm_* parameters on the host page's URL are passed through automatically.
JS API
When you need a custom trigger (e.g. your own designed button opening the popup), call the API directly:
<script src="https://YOUR_QUIZ_DOMAIN/embed.js"></script>
<script>
// Mount an inline embed manually
RooQuiz.embed({ el: '#container', token: 'YOUR_QUIZ_TOKEN', utmSource: 'homepage' })
// Open the popup from any element
document.querySelector('#my-button').onclick = () => RooQuiz.open('YOUR_QUIZ_TOKEN', { utmSource: 'homepage' })
</script>The embedded page automatically hides the footer and background, blending transparently into your site; your theme colors still apply. Responses collected through embeds appear in Response Records as usual.
Public Link & QR Code
The public link is the most common way to hand out a quiz. How to copy it, generate and download a QR code for print or slides, and what changes when the quiz requires sign-in.
Social Share Card
The social share card (Open Graph) is what chat apps and social platforms show when your quiz link is pasted. Customise the title, description and preview image to lift click-through.