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:
| Type | Description | Example use |
|---|---|---|
| Single choice | One option from several | What's your budget? ◉ Under $500 ○ $500–1000 ○ 1000+ |
| Multiple choice | Several options at once | What interests you? ☑ Price ☑ Design ☐ Timeline |
| Picture choice | Image options instead of text | Which apartment style do you prefer? |
| Short text | Single line of free text | Enter your company name |
| Text area | Multi-line text | Describe your project in more detail |
| Number | Numeric input with validation | Number of rooms: [2] |
| Email with format validation | Your address: user@email.com | |
| Slider | Range with min/max/step | Budget: ——●—— $2,500 |
| Rating | Stars, emoji or numbers | Rate importance from 1 to 5 |
| Date / Time | Date and/or time picker | When would you like to view the apartment? |
| Tags | Choose multiple tags from a list | Select your interests |
| Address | Postal address field | Enter your delivery address |
| File | Photo or document upload | Attach 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
| Operator | Meaning |
|---|---|
| is selected / not selected | For choice-type questions |
| equals / does not equal | Exact text or number match |
| contains / does not contain | Partial text match |
| greater / less / ≥ / ≤ | Numeric comparisons |
| is answered / not answered | Checks 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#
PremiumAdd 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#
PremiumAutomatically 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.
