Publishing & Embedding

How to Publish a Quiz#

Once you're happy with your quiz — publish it to make it accessible to visitors.

1. 1In the builder click "Publish" or go to the Publish tab in the top menu.
2. 2The system automatically checks the quiz for errors. If there are issues — fix them and try again.
3. 3The quiz gets the status "Published" and becomes accessible via its public link.

Public Link#

After publishing, the quiz is accessible at:

https://qwizoo.com/q/Ab3cD4eF

You can share this link directly: on social media, in messaging apps, ad campaigns or email newsletters.

• Unique ID — an 8-character quiz identifier, generated automatically on creation. Immutable and guaranteed to be unique.
• The link is active while the quiz has "Published" status. An archived quiz no longer accepts submissions.

Embedding on Your Site#

Qwizoo offers several ways to embed a quiz on your site:

Inline embed

Copy the code from the Publish page → "Embed" tab and paste it into your site's HTML:

<!-- Qwizoo inline embed -->
<div data-quiz="Ab3cD4eF"></div>
<script src="https://qwizoo.com/embed.js" defer></script>

• The quiz automatically adapts to the parent container width.
• Height adjusts dynamically — the iframe grows and shrinks with the quiz content.
• Works on any site: WordPress, Tilda, Wix, custom HTML.

Popup modal

The quiz opens in a modal when a button is clicked:

<!-- Qwizoo popup -->
<div data-quiz="Ab3cD4eF" data-mode="popup" data-trigger-label="Take the Quiz"></div>
<script src="https://qwizoo.com/embed.js" defer></script>

UTM Parameters & Tracking#

Qwizoo automatically captures UTM parameters from the quiz URL and saves them with each lead. This lets you track where leads come from.

Supported parameters:

• utm_source — traffic source
• utm_medium — channel (cpc, email, etc.)
• utm_campaign — campaign name
• utm_content — ad variant
• utm_term — keyword

Example link with UTM:

https://qwizoo.com/q/Ab3cD4eF?utm_source=facebook&utm_medium=cpc&utm_campaign=spring

Custom Domain#

On the Premium plan you can publish a quiz on your own domain, for example:

https://quiz.brand.com

The URL is clean — no path after the domain. Technically Qwizoo performs an internal rewrite: the visitor sees quiz.brand.com, not the quiz's public ID.

Setup

1. 1In Settings → Custom Domain enter your subdomain (e.g. quiz.yourbrand.com).
2. 2Add a CNAME record in your domain's DNS:
   Copy

   quiz.yourbrand.com  CNAME  cname.qwizoo.com

3. 3Wait 5 minutes to 48 hours for DNS propagation.
4. 4Qwizoo will automatically issue an SSL certificate for your domain. You can track the status in settings.

Full White Label#

On the Premium plan you can completely remove any mention of Qwizoo — your clients only see your brand. White label consists of three components:

• "Powered by Qwizoo" badge — hide it in Settings → White Label. Available from the Comfort plan.
• Custom domain — quiz published at your address (e.g. quiz.brand.com) — clean URL with no path. Setup described above.
• Custom sender email — Follow-up emails sent from your address (e.g. team@yourbrand.com). Configure in Settings → Email Domains after verifying the domain via DNS records (SPF/DKIM).

When all three components are configured — a green "Qwizoo completely hidden" badge appears in the White Label status on the settings page.

SEO & Meta Tags#

On the Publish page → "SEO" tab you can configure:

• Title — page title for search engines.
• Description — description for Google snippets.
• OG Title / OG Description — text displayed when shared on social media.
• OG Image — preview image for social networks (recommended size: 1200×630 px).

Popup & Float Embed#

In addition to standard inline embed, Qwizoo supports two more display modes:

Popup (modal overlay)

The quiz opens in a central modal window over the page. The background is blocked by an overlay.

<!-- Popup: opens when the button is clicked -->
<div data-quiz="Ab3cD4eF" data-mode="popup" data-trigger-label="Take the Quiz"></div>
<script src="https://qwizoo.com/embed.js" defer></script>

Float (floating button)

A floating button appears in a corner of the page. Clicking it opens the quiz in a compact panel next to the button. Ideal for unobtrusive visitor engagement without covering page content.

<!-- Float: floating button in the bottom-right corner -->
<div
  data-quiz="Ab3cD4eF"
  data-mode="float"
  data-position="bottom-right"
  data-trigger-label="Take the Quiz"
></div>
<script src="https://qwizoo.com/embed.js" defer></script>

Dynamic Content#

Qwizoo supports substituting variables from URL parameters directly into quiz text using the syntax {{parameter_name}}.

Example: if the quiz is opened at https://qwizoo.com/q/your-quiz?name=John, the Welcome step text "Hi, {{name}}!" will automatically become "Hi, John!".

• The double-curly-brace syntax works in any text field of the quiz.
• If the parameter is absent from the URL — the variable is replaced with an empty string.
• Useful for personalised email campaigns and ads — each visitor sees the quiz with their own name.

Hidden Fields#

Hidden fields are URL parameters that are automatically saved with each lead but are not shown to the visitor. This lets you pass extra contextual information from your ads or CRM into the quiz.

Example link with hidden fields:

https://qwizoo.com/q/Ab3cD4eF?source=google&campaign=spring&manager_id=42

The lead details will contain fields source=google, campaign=spring and manager_id=42 — convenient for lead attribution and automatic assignment to managers in your CRM.

WordPress Plugin#

The official Qwizoo WordPress plugin lets you embed quizzes on a WordPress site without copying embed code — via a native Gutenberg block or the [qwizoo] shortcode.

Installation

1. 1Go to Settings → API Keys in your Qwizoo account and generate a new key named "WordPress Plugin".
2. 2In WordPress Admin go to Plugins → Add New, search for "Qwizoo" and install the plugin. Or download the ZIP from wordpress.org/plugins/qwizoo-quiz-lead-generation.
3. 3Activate the plugin and go to Qwizoo in the WordPress sidebar. Paste the API key and click Connect.
4. 4Your quiz list will load automatically — the plugin is ready to use.

Gutenberg Block

In the block editor click +, find the Qwizoo Quiz block and insert it on the page. In the inspector panel (right) choose a quiz from the list and configure the embed mode.

Shortcode

Works in any page builder, classic editor or widget:

[qwizoo id="Ab3cD4eF"]

[qwizoo id="Ab3cD4eF" mode="popup" trigger="Take the Quiz"]

[qwizoo id="Ab3cD4eF" mode="float" position="bottom-right"]

Embed Modes via Plugin

Result Sharing#

After completing the quiz, the visitor can share their result on social networks. Native sharing buttons appear on the Result step:

• X (Twitter) — posts a tweet with the result headline and a link to the quiz.
• Facebook — opens the share dialog with OG preview.
• WhatsApp — sends a message with the result text.
• Telegram — opens Telegram with pre-filled text.
• LinkedIn — posts to the LinkedIn feed.

Sharing buttons are enabled in the Result step settings → toggle "Allow result sharing". The post text is generated automatically from the result headline, but can be customised manually.