Quiz Builder

A full overview of the builder: steps, questions, logic, design and settings.

Updated: April 2026

Builder Interface#

The quiz builder is divided into three zones:

  • Left panel (steps) — a list of all quiz steps; drag to reorder.
  • Centre panel (editor) — edit the selected step's content: headline, answer options, settings.
  • Right panel (preview) — a live preview of how the quiz looks to visitors.
💡

Click "Preview" in the top menu to see a full-screen view of the quiz exactly as visitors see it.


Step Types#

Every quiz is made up of a sequence of steps. There are 8 core types:

👋

Welcome

The quiz start screen. Contains a headline, description, cover image and start button. Recommended for explaining your value proposition.

Question

The main question step. Supports 12 answer formats — from simple choice to ratings and file uploads.

📋

Lead Form

Contact collection form: name, email, phone. Supports two-step collection (email first, then phone).

🏆

Result

Personalised result based on score or answers. You can create multiple results for different audience segments.

🎉

Thank You

Final screen after contact collection. Supports redirect to any URL.

🎬

Video

Embeds a video from YouTube, YouTube Shorts or Vimeo directly in a quiz step. Optional autoplay — handy for short product presentations. Comfort+

📅

Calendar

A booking step for meetings or calls. Displays a link to your calendar system (Calendly, Cal.com, etc.) — the visitor picks a convenient time right inside the quiz.

🧮

Formula Calculator

A calculator step that computes a numeric result from the user's answers using a defined formula. Shows the total (budget, weight, cost, etc.) directly in the quiz. Comfort+


Question Types#

On a Question step you can choose one of 12 answer formats:

TypeDescriptionExample use
Single choiceOne option from severalWhat's your budget? ◉ Under $500 ○ $500–1000 ○ 1000+
Multiple choiceSeveral options at onceWhat interests you? ☑ Price ☑ Design ☐ Timeline
Picture choiceImage options instead of textWhich apartment style do you prefer?
Short textSingle line of free textEnter your company name
Text areaMulti-line textDescribe your project in more detail
NumberNumeric input with validationNumber of rooms: [2]
EmailEmail with format validationYour address: user@email.com
SliderRange with min/max/stepBudget: ——●—— $2,500
RatingStars, emoji or numbersRate importance from 1 to 5
Date / TimeDate and/or time pickerWhen would you like to view the apartment?
TagsChoose multiple tags from a listSelect your interests
AddressPostal address fieldEnter your delivery address
FilePhoto or document uploadAttach your technical brief

Branch Logic#

Every step can have conditional transition rules — depending on the user's answer the quiz shows different next steps.

How to Set Up

  • Select a step in the left panel and switch to the "Logic" tab.
  • Click "+ Add Rule".
  • Choose a condition: if answer is / is not / contains / is greater than, etc.
  • Specify the step to go to when the condition is met.
  • Set a "Default" step — the fallback for anyone who doesn't match any rule.

Available Operators

OperatorMeaning
is selected / not selectedFor choice-type questions
equals / does not equalExact text or number match
contains / does not containPartial text match
greater / less / ≥ / ≤Numeric comparisons
is answered / not answeredChecks whether an answer was given
score ≥ / ≤Compares accumulated score
💡

Rules are evaluated top to bottom. The first matching rule determines the transition. Don't forget to set a default step.


Score Calculator#

You can assign numeric points to each answer option. The total score accumulates across the quiz and determines which Result step is shown to the user.

  • Enable "Scoring Mode" in quiz settings.
  • On each question step → in the answer option → enter the number of points.
  • On the Result step → set a score range for each result (e.g. 0–10, 11–20, 21+).

Design & Branding#

The "Design" tab in the builder's right panel lets you fully customise the quiz appearance:

🎨

Colours

Primary colour, card background, text colour, button style (rounded / square / pill).

🔤

Font

Choose a font and question text size (small / medium / large).

🖼️

Cover image

Image on the left, right or top. Modes: cover, contain, square.

🏷️

Logo

Upload a PNG with transparent background — displayed at the top of the quiz. Comfort+

📐

Split layout

Horizontal layout: image on the left, content on the right. Comfort+

🚫

Remove branding

Hide the "Powered by Qwizoo" badge at the bottom. Comfort+


AI Quiz Generation#

Comfort+

Not sure how to start? Describe your topic in a few words — AI will build the structure, questions, answer options and contact form in seconds.

  • Click "Generate with AI" in the builder's top menu.
  • Enter a description: e.g. "Quiz for choosing a smartphone".
  • Specify the number of questions and quiz type (lead generation, test, recommendation).
  • AI will generate the full structure — you can edit every step afterwards.
⚠️

AI generation uses Anthropic Claude. Quiz answers may be sent to the API to improve the result. See the Privacy Policy for details.


Pre-publish Validation#

Before publishing, Qwizoo automatically checks the quiz for:

  • Empty steps with no content.
  • First step not being a Result or Thank You.
  • No "dead" references in branch logic.
  • No circular transitions.
  • At least one Lead Form step (if contact collection is enabled).

If there are errors the system displays the list and blocks publishing until they are fixed.


Templates#

When creating a new quiz there are 10 ready-made templates for the most common scenarios. Templates include a complete structure: Welcome step, questions, Lead Form and Result.

Examples of available templates:

  • Product recommendation for e-commerce — recommendation quiz for an online store.
  • Real estate — buyer qualification: budget, area, number of rooms.
  • Fitness & health — training programme or nutrition plan recommendation.
  • B2B qualification — identify client needs and purchase readiness.
  • Online education — knowledge test or course recommendation.
💡

A template is only a starting point. After choosing one you can edit every step, change texts, add or remove questions.


Duplicate, Archive, Trash#

In the quiz list each quiz has a context menu with three actions:

  • Duplicate — creates an exact copy of the quiz with all steps, design and settings. The copy gets a "Draft" status and a new unique public link. Convenient for A/B tests or adapting a quiz to a new segment.
  • Archive — the quiz disappears from the "Active" list but all data (leads, analytics) is preserved. An archived quiz no longer accepts new submissions. Can be unarchived at any time.
  • Move to Trash — soft delete: the quiz is moved to the trash and automatically deleted after 30 days. Until then it can be restored in the Trash section in settings.

Scoring & Answer Explanations#

Scoring mode supports two additional features for educational and knowledge quizzes:

Knowledge Test Mode

Enable "Knowledge Test Mode" in quiz settings — then the correct answer earns points and the wrong one earns none (or negative points). The system automatically shows the result: how many correct answers out of the total.

Answer Explanations

For each answer option you can set an explanation text — shown to the visitor immediately after selecting that option (before moving to the next step). Useful in tests: "Correct! Vitamin D is produced through sunlight exposure" or "Not quite — try again".


Result Step with Score Ranges#

A Result step supports displaying different results depending on the accumulated score. This lets you personalise the final screen for different audience segments.

Example range configuration:

  • 0–30 points → Result A: "Beginner — here's a starter plan".
  • 31–70 points → Result B: "Intermediate level — we recommend the Middle course".
  • 71–100 points → Result C: "Expert — the Advanced programme is right for you".

For each Result step set the minimum and maximum score in the "Score Range" field in the step editor.


Result Gating#

Result gating is an option that shows the contact form before revealing the result. The visitor sees something like: "Your result is ready — enter your email to receive it".

  • Enable "Show form before result" in the Lead Form step settings.
  • After filling in the form the visitor proceeds to the Result step. If the form is closed the result is not shown.
💡

Result gating significantly improves lead conversion — people have already completed the quiz and are interested in the result, so they are more willing to share their contact details.


Multi-step Lead Form#

Lead Form supports two-phase contact collection: data is gathered in two stages, which improves conversion — the visitor does not see a large form all at once.

  • Phase 1 (minimal data) — e.g. email only, or name + email. Data is saved immediately when moving to the next step, even if the visitor does not finish the quiz.
  • Phase 2 (additional data) — phone, company or other fields. Filled in on the next form step or on a separate Lead Form step.

If a visitor left their email on the first step but did not finish the quiz — the partial lead is still added to your database, marked as "Incomplete".


File Upload Question#

Comfort+

The File upload question type lets quiz takers attach a file as part of their answer — a photo, PDF, or document.

  • In Question editor → Question type → File upload
  • Configure allowed types: image (JPG/PNG/WebP), PDF, or DOC/DOCX
  • Set max file size: 5 MB or 10 MB
  • Toggle Required to force the user to attach a file before continuing
💡

Uploaded files are stored in Cloudflare R2 and the URL is saved with the lead answer. Files are accessible as clickable links in the lead detail drawer.


Product Recommendation Result#

Instead of a score-based result, show a product recommendation card — perfect for e-commerce quizzes that suggest a specific product based on answers.

  • General settings → Result mode → Product card
  • For each result, configure: image URL, product name, price, currency, CTA button label and URL
  • Add up to 5 additional feature bullets shown on the card
💡

Combine with score ranges: different score ranges → different product recommendations (e.g. budget product vs premium product).


Payment Step#

Premium

Add a payment step to your quiz to collect payments via Stripe Connect. Perfect for paid assessments, consultations, or micro-products sold through the quiz funnel.

Stripe Connect setup

  • Settings → Integrations → Stripe → Connect your Stripe account
  • You are redirected to Stripe Express onboarding — complete KYC once
  • After onboarding, your account is active and ready to receive payments

Configuring the payment step

  • In the builder, add a Payment step (in Add step menu)
  • Set: product name, description, amount, currency (USD / UAH / EUR)
  • Set the button label (e.g. "Pay & get result")
  • The payment step shows a Stripe-hosted card form. After success, the quiz continues automatically.
💡

Place the payment step before the Result step to gate the result behind payment. Stripe handles all PCI compliance — Qwizoo never stores card data.


PDF Certificates#

Premium

Automatically generate a branded PDF certificate for quiz takers who pass a knowledge test or scored quiz. Certificates appear on the Thank You step and can be downloaded instantly.

  • Builder → Features → Certificate
  • Set pass score % — only users who reach this threshold receive a certificate
  • Configure: course name, signer name and title, logo URL, accent color, footer note
  • Choose style: Classic, Modern, or Minimal
💡

Certificates are generated client-side in the browser using @react-pdf/renderer — no server round-trip needed and no PDF storage cost.


Public Quiz Catalog#

Comfort+

List your quiz in the public Qwizoo catalog at qwizoo.com/quizzes. Cataloged quizzes are indexed by search engines and discoverable by new users.

  • Builder → Sharing → Public catalog → toggle Show in public catalog
  • Select a category (Business, Education, E-commerce, Health, etc.)
  • Add a preview image URL shown on the catalog card
💡

Set a good SEO title and SEO description (in General settings → SEO tab) — these are used as the page title and meta description on the catalog detail page.


Chat / Conversational Mode#

Comfort+

Switch any quiz from the default card-per-question layout to a chatbot-style conversation. Questions appear as bot messages, visitor answers appear as user messages — the exact same quiz logic runs under the hood.

  • Builder → Design → Display mode → select Chat
  • Set a Bot name (default: "Qwizoo Bot") and optional avatar URL
  • Adjust typing delay (ms) — how long the bot "types" before the next message appears
💡

All branch logic, scoring, lead forms, result steps and integrations work identically in chat mode. Only the visual rendering changes.


Multi-Language Quiz#

Comfort+

Serve the same quiz in multiple languages without duplicating it. Translations are stored per step and swapped automatically based on the visitor's browser language or a ?lang= URL parameter.

  • Builder → Features → Languages
  • Enable multi-language and select which languages to support (EN, UK, RU, DE, PL, FR…)
  • Set a default language — used as fallback if no translation exists
  • Choose language detection: browser auto-detect, URL param (?lang=uk), or manual switcher
  • Toggle Show language switcher — adds a dropdown on the public quiz
  • Per-step translation: in each step editor open the translation tab for the language and fill in translated title, description and choice labels
💡

Answer values are always saved in their original language regardless of which translation the visitor sees — your CRM and analytics receive consistent values.