Embedding & Sharing a Quiz

Every published quiz gets a shareable link, plus a ready-made iframe snippet for embedding it directly on your own website.

Last updated

How do I embed my quiz on my website?

Open the quiz's menu and choose "Copy embed code" — it copies an iframe pointed at your quiz's share link with ?embed=true appended, ready to paste into your site's HTML.

The embed snippet#

The quiz menu's "Copy embed code" action copies this exact snippet, with your quiz's share link and a ?embed=true query parameter that switches the page into an embed-friendly layout:

<iframe src="https://fluotest.com/to/your-username/your-quiz?embed=true" width="100%" height="600" frameborder="0" style="border:none;border-radius:8px;" allow="clipboard-write"></iframe>

Embed types: Popup, Slide-in, Exit-intent#

Beyond the plain inline iframe, the embed dialog can generate a single script tag instead — it loads embed-widget.js, which renders your quiz as a floating popup button, a slide-in panel from a corner, or a prompt that appears on exit-intent. Pick the mode in the embed dialog; the snippet below shows the Popup mode.

<script src="https://fluotest.com/embed-widget.js" data-quiz-url="https://fluotest.com/to/your-username/your-quiz" data-mode="popup" async></script>

data-mode accepts popup, slidein, or exit-intent. Optional attributes: data-button-text (popup/slide-in trigger label), data-color (accent color, defaults to FluoTest purple), data-position (bottom-right or bottom-left), and data-delay (slide-in delay in milliseconds, default 4000).

Adjusting height and width#

The snippet ships with a fixed height of 600px and a width of 100%. There's no automatic resizing, so if your quiz has many questions or a long results screen, increase the height attribute — a good starting point is testing the embed with a full run-through and adjusting until nothing gets clipped.

Badge removal and custom domains#

Free quizzes show a "Powered by FluoTest" badge on both the hosted page and the embed. Pro removes it. If you've connected a custom domain, check your domain settings for the exact link to use in place of fluotest.com.

Troubleshooting#

  • The embed looks cut off or has a scrollbar: Increase the height attribute on the iframe tag — the default 600px is a starting point, not a fixed limit.
  • The quiz doesn't load in the iframe: Confirm the quiz is published, not soft-deleted, and that the share link works when opened directly in a new tab.
  • The "Powered by FluoTest" badge still shows on Pro: Confirm the workspace is actually on Pro (or grandfathered) — the badge is tied to the quiz owner's plan, not to the page it's embedded on.
  • The popup, slide-in, or exit-intent quiz doesn't appear: Check that the script tag isn't blocked by a Content-Security-Policy that disallows third-party scripts or iframes — allow fluotest.com in your CSP. Exit-intent only fires once per browser session and only on desktop pointer movement, not on mobile.

Frequently asked questions#

Do I need any code beyond the iframe snippet to embed a quiz?

No — the copied iframe snippet is self-contained. Paste it into your site's HTML wherever you want the quiz to appear.

Does the embedded quiz look different from the hosted version?

The ?embed=true parameter switches to a layout suited to being embedded (for example, without FluoTest's own page chrome around it), but the quiz content and behavior are the same.

Can I share the link directly instead of embedding it?

Yes — the same share link works as a standalone page. Use the plain link (without ?embed=true) for that.

What's the difference between the iframe snippet and the script snippet?

The iframe snippet renders the quiz inline, exactly where you paste it. The script snippet (used for Popup, Slide-in, and Exit-intent) instead loads a small script that builds the trigger (a button, panel, or exit prompt) and only creates the iframe when the visitor engages with it.