Quizzes

Quizzes

Build interactive quizzes with AI, personalized results pages, and shareable links for your brand.

What is Quizzes?

Quizzes (also called the quiz builder) is the SWAI app where you create multi-page quizzes and interactive forms, design personalized results pages, publish a public link, and review basic funnel stats.

You use it to:

• Create quizzes from scratch or with AI Build
• Refine questions, prompts, results, and design with the floating AI assistant bar
• Add question pages, drag-and-drop elements (including display-only Statement text), and required fields
• Branch with Next Button Logic and multiple result variations
• Build outcome pages with smart components (score, charts, AI copy) and static blocks (headline, webinar, button)
• Theme the quiz and results under Design (layout, colors, waiting message, social share)
• Optionally add contacts to a Nurturing Assistant and/or CRM lists, inject GTM scripts, and enable social sharing
• Save drafts, Publish a live link, Preview, and View Stats

Main screens

Note: Open Quizzes from the SWAI Dashboard (Apps → Quizzes). It uses your brand session — there is no separate sign-up inside the quiz builder.

Before you start

Checklist

1. Open Quizzes from SWAI
   Use Apps → Quizzes (/apps/quizzes) so you are signed in for the correct brand.

2. Brand profile
   Keep brand name, assets, and audience details up to date — AI Build and on-brand results use them.

3. Asset Library (for images and video)
   Have media ready in your SWAI file library. You pick assets with Select from asset library / Pick from asset library.

4. Webinars (optional)
   If a results page should embed webinar registration, create the webinar first under Webinar Pro.

5. Nurturing assistant (optional)
   If Design → Add contact to Nurturing Assistant should run after submit, have a launched assistant for the brand.

6. CRM lists (optional)
   If Design → Add contact to CRM List should run after submit, create the lists you need under Contacts for the brand first.

Important warnings

Warning: If Quizzes does not load or you lose brand context, close the tab and open Apps → Quizzes again from the SWAI Dashboard.

Warning: A quiz that is only a Draft is not available on the public URL. Visitors see Quiz not found until you Publish.

Warning: Delete quiz cannot be undone (This cannot be undone.).

Tip: Create and edit open in a new tab. Keep the Quizzes list tab so you can return to search and stats.

Tip: Save stores a draft. Publish makes the current quiz live for visitors. They are not the same step.

Quick start

1. Open Apps → Quizzes in the SWAI Dashboard.
2. Click Create quiz. The builder opens in a new tab.
3. Optionally click AI Build, describe the quiz (or pick Trivia Quiz, Personality Quiz, or Product Quiz), then Generate Quiz.
4. On Build, add or edit Pages and drag Elements onto the canvas.
5. Switch to Results. Add Smart Components and Normal Components, and set up Variations if you need different outcomes.
6. Open Design to set Long Quiz or Step-by-Step, colors, waiting message, and optional social share, nurturing, or CRM lists.
7. Use the bottom AI assistant bar anytime to tweak questions, prompts, results, or design in plain language.
8. Click Preview to walk through the taker flow.
9. Click Save for a draft, or Publish when ready. Use the toast link or View Quiz to open the public URL.
10. Back on the Quizzes list, use View Stats to see Impressions, Started, and Finished.

Note: Click the quiz title in the builder header to rename it (default titles include My New Quiz / Untitled Quiz).

Quizzes list

Path: Apps → Quizzes.

From the list you can:

• Search (Search quizzes…)
• Create quiz
• Open actions for a quiz: Preview, Edit, Duplicate, View Stats, Delete

Empty: No quizzes found for this brand.
No search hits: No quizzes match "…" — use Clear search.

Create quiz

1. Click Create quiz.
2. A new builder opens with a starter page (often titled Start) and a welcome Image/Intro block.
3. Edit pages and results, then Save or Publish.

Duplicate quiz

1. Open actions → Duplicate.
2. Confirm Duplicate quiz — A new quiz will be created with the same content.
3. Toast: Quiz duplicated.

Delete quiz

1. Open actions → Delete.
2. Confirm Delete quiz — This cannot be undone.
3. Toast: Quiz deleted.

View Stats

Open View Stats / Quiz statistics:

Close the stats dialog when finished.

AI Build

In the builder, click AI Build to open AI Quiz Flow.

• Subtitle: Describe the quiz you want, and we'll generate a quiz flow instantly.
• Field: What is this quiz about?
• Suggestion chips: Trivia Quiz, Personality Quiz, Product Quiz
• Click Generate Quiz (you may see Generating Magic…)

AI can replace the quiz structure and seed a default results layout (and may attach webinars when your brand has them).

Warning: Review generated pages and results before you Publish. Adjust branching, variations, and Design as needed.

Tip: Use AI Build when you want a full quiz generated from a description. Use the floating AI assistant bar (below) for smaller edits to an existing quiz.

AI assistant (chat bar)

While you edit on Build or Results, a floating AI assistant bar sits at the bottom of the builder. Use it to change the current quiz with plain-language requests—without regenerating everything from scratch.

How to use it

1. Click in the box (Ask AI to change the quiz, prompts, results, or design…).
2. Type what you want, then Send (or press Enter). Use Shift+Enter for a new line.
3. Wait for the status to finish (for example Thinking… / Updating quiz…). Changes apply on the canvas.
4. Save or Publish when you are happy—the assistant does not publish for you.

Other controls:

What you can ask

Examples:

• Rewrite or add questions; add a Statement (display-only text)
• Change colors, layout mode, or card styling
• Update Next Button Logic or branching to a named result variation
• Edit result AI Generation Prompts, add result components, or set a Page compose prompt
• Help wire Add contact to Nurturing Assistant or Add contact to CRM List when those options exist for your brand

Tip: Name the page, variation, or element in your request (for example “On the Welcome page…” or “In the High score variation…”) so the assistant targets the right place.

Tip: Use Undo if an AI change is not what you wanted, then rephrase and try again—or edit Properties manually.

AI Build vs AI assistant

Visual builder

Opened from Create quiz or Edit.

Progress: open → Build → Results → Design → Preview → Save or Publish (use the AI assistant anytime while editing).

Main builder areas

Header controls

Tip: Use Save while iterating. Use Publish when the public link should work for visitors.

Build mode

Pages

Under Pages you can:

• Select a page to edit on the canvas
• Reorder pages by dragging
• Add a page with +
• Delete a page

Empty page title may show Untitled Page.

Canvas empty state: Drag and drop elements here.

Page Settings

With a page selected in Properties:

• Page Title
• Next Button Logic — natural-language rule for where the taker goes next (Leave empty for linear sequence…)

If logic is empty, pages run in order. On the last page, the taker Submits. With logic filled, AI can choose the next page, finish the quiz (Submit), and optionally a result variation by name.

Editing long prompts

For longer instructions, use Edit in larger editor (expand / maximize icon) next to:

• Next Button Logic (page settings)
• Page compose prompt (result variation)
• AI Generation Prompt (smart result components)

A larger writing window opens; edit freely, then click Done. You can still make short edits in the sidebar without opening the modal.

Question and display elements

Drag from Elements (Drag to Canvas):

For a selected block, configure question/label, description, options, placeholder, image/video URL (Asset Library), and Required (input fields only).

Warning: Required fields show This field is required for takers. Display-only blocks (Statement, Image/Intro, Video) are not answer fields—do not treat them as required questions.

Layout modes (Design)

Open Design from the header:

Optional (Step-by-Step only): Auto-next after last answer — when the last field on a page is rating or single-choice (radio/dropdown), advance automatically.

Also set Card width for Quiz (questions) and Results (default or custom 320–1280px).

Results mode

Switch the header to Results. The canvas shows how users see their outcome (Your Results / This is how the user will see their result.).

How results are generated

After a taker finishes the quiz (or you click through Preview and submit):

1. SWAI reads their answers.
2. Each Smart Component uses its own AI Generation Prompt plus those answers to create its content (score text, chart data, smart image, redirect URL, and similar).
3. The active result variation (often Default, or another named variation from Next Button Logic) provides the layout.
4. The optional Page compose prompt steers overall tone and layout of the composed results page.
5. While this runs, takers see the Design Waiting message (or Working on it... if empty).
6. Normal Components (headline, button, webinar, and similar) show fixed content you configured—they are not regenerated from answers.

You write the prompts and layout in the builder; the personalized content is created at preview/submit time—not when you type the prompt.

Components vs Variations

Add a variation with +. Rename or delete variations from the list (you cannot remove the required Default variation in normal use).

Set the page compose prompt (variation)

1. Switch to Results.
2. Open Variations and select the variation (or leave Default selected).
3. In the right Properties panel, set Variation name if needed.
4. Enter Page compose prompt (tone and layout for the whole results page).
5. For longer text, click Edit in larger editor, then Done.
6. Save or Publish.

Smart Components

AI-driven outcome blocks. Each one needs an AI Generation Prompt that tells the AI what to produce from the taker’s answers.

How to update a smart component prompt

1. Switch the header to Results.
2. Select the variation that contains the component (Variations → choose it, or stay on Default).
3. Click the smart component on the canvas (for example Descriptive Text or Score Display).
4. In the right Properties panel, find AI Generation Prompt (Describe what the AI should generate based on the user's quiz answers.).
5. Edit the prompt in the sidebar, or click Edit in larger editor, write your instructions, then Done.
6. Optionally set a Title for the block if shown.
7. Save or Publish, then use Preview and complete the quiz to see the new generated content.

Tip: Be specific (tone, length, what to emphasize from answers). Vague prompts produce vague results.

Tip: You can also ask the floating AI assistant to update a prompt—still verify it in Properties afterward.

Normal Components

Static or configured blocks (no AI Generation Prompt):

Select a normal component on the canvas → edit its fields in Properties (title, URL, webinar, HTML, and similar).

Note: The Webinar picker needs a saved quiz in brand context. If webinars fail to load, reopen Quizzes from the Dashboard and save the quiz first.

Tip: Name result variations clearly (for example “High score”, “Product A”) and reference those names in Next Button Logic.

Design, branding, and integrations

Open Design from the header or from the AI assistant bar palette to configure:

Look and feel

• Quiz Page Background and optional Quiz Page Background Image (URL or Asset Library)
• Results Page Background and optional Results Page Background Image (falls back to the quiz page look when empty)
• Card Background (quiz & results), Input Background
• Text Color, Button/Accent
• Show shadow (Quiz / Results), Show Border, Border Radius
• Typography (fonts such as Inter, Roboto, Open Sans, Poppins, Playfair Display, and others)
• Hide Quiz Title, Hide Results Title
• Card width for Quiz (questions) and Results (default or custom)

Waiting message

Waiting message — text shown while results are preparing after the taker submits (for example while scores, charts, or smart images generate). If empty, takers see the default Working on it...

Share on social

Enable Share on social so results can show Share this quiz (Facebook, X, LinkedIn, WhatsApp, Copy link / Copied, native Share).

Nurturing Assistant

Add contact to Nurturing Assistant — select an assistant (None, or a brand agent). After submit, the quiz can silently create/map a contact for that assistant.

• Loading: Loading assistants…
• Empty: No nurturing assistants found for this brand.

Warning: If the list fails (Failed to load nurturing assistants), reopen Quizzes from the Dashboard with brand context.

Add contact to CRM List

Add contact to CRM List — optionally select one or more CRM lists for the brand. After a quiz is submitted, the contact is created or updated in CRM and added to the selected lists.

1. Open Design in the builder.
2. Find Add contact to CRM List (below Add contact to Nurturing Assistant).
3. Search and select lists (Search lists…; after the first selection, Add another list…). Selected lists appear as chips — remove a chip to deselect.
4. Leave empty to skip CRM list membership.
5. Save or Publish — there is no separate CRM step on publish.

Note: This is optional. The quiz taker never sees a CRM form — membership is applied in the background after submit when lists are selected.

Warning: If lists fail to load (Failed to load contact lists), reopen Quizzes from Apps → Quizzes with brand context.

Tip: You can use Add contact to CRM List together with Add contact to Nurturing Assistant. Lists still apply after submit when selected.

Custom Scripts (GTM)

Custom Scripts (GTM) / Edit scripts — paste head and body snippets for published quizzes.

Preview, publish, and share

Preview

Click Preview to simulate the taker experience. On submit, the builder runs the results pipeline so you can check scores, charts, and composed layout before publishing.

Save vs Publish

Failures may toast Failed to save draft. Please try again. or Failed to publish quiz. Please try again.

Public URL

Published quizzes are available at the quiz host path /{quizId} (for example on quiz.app.swai.ai).

If the quiz is missing or still a draft:

• Heading: Quiz not found
• Message: This quiz doesn't exist or isn't published yet. Publish it from the builder to make it available.

Export and Import

From Export / Import:

• Export Quiz — download JSON
• Import Quiz — upload a quiz JSON export; choose Overwrite current or Create new quiz

Use quizzes with other SWAI apps

Related Help: Page Builder, Campaign Builder, File Library, Webinar, Conversational Agents, CRM, Notifications.

Common warnings and troubleshooting

Quiz not found on the public link

Publish the quiz from the builder (Publish). Draft quizzes are not live.

Quizzes list empty or wrong brand

Open Apps → Quizzes again from the SWAI Dashboard for the correct brand. Empty list: No quizzes found for this brand.

AI Build did not match what I wanted

Retry AI Build with a clearer prompt, or edit pages and results manually after generation. For small fixes, prefer the floating AI assistant bar instead of regenerating the whole quiz.

AI assistant did not change what I expected

1. Rephrase and name the page, variation, or element (for example “Update the email question on the Contact page”).
2. Use Undo, then try again.
3. Or select the item on the canvas and edit Properties yourself (use Edit in larger editor for long prompts).
4. Remember to Save or Publish—AI edits stay in the builder until you save.

Branching always goes linear

Fill Next Button Logic on the relevant pages. Leave empty only when you want a linear sequence. Name Variations and reference those names in the logic when outcomes should differ.

Webinar picker empty or fails

1. Confirm you opened Quizzes from the Dashboard.
2. Save the quiz so it has a stable id.
3. Confirm webinars exist for the brand in Webinar Pro.

Assets or nurturing assistants won’t load

Reopen Quizzes from Apps → Quizzes so brand and session tokens are set. Standalone bookmarks without embed context often fail these pickers.

CRM lists won’t load

If Design shows Failed to load contact lists or No CRM lists found for this brand.:

1. Reopen Apps → Quizzes from the SWAI Dashboard for the correct brand.
2. Confirm CRM lists exist under Contacts for that brand.
3. Open the quiz → Design → Add contact to CRM List again.

Contact not added to CRM lists after submit

1. Confirm the quiz is Published (drafts are not live).
2. In Design, confirm one or more lists are selected under Add contact to CRM List, then Save or Publish again.
3. Have the taker complete the quiz with enough contact details (for example name, email, or phone) so CRM can create or update the contact.
4. Check Contacts for the brand and the selected lists.

Required field blocks submit

Takers see This field is required. Clear Required on display-only blocks, or fill the field when testing in Preview.

Smart Image or compose takes a long time

AI result composition (especially Smart Image and page compose) can take tens of seconds. Wait for Preview/results to finish; retry if the run fails. Customize the spinner text under Design → Waiting message.

Stats look low

• Impressions need the public quiz to load.
• Started needs a first Next or Submit.
• Finished needs the results page to be viewed.

Import or export failed

Retry Export Quiz / Import Quiz. Confirm the file is a quiz JSON export from this builder.

Delete or duplicate confirmation

• Delete: This cannot be undone.
• Duplicate: A new quiz will be created with the same content.

Glossary

Need more help?

If something still fails after the checklist above:

1. Confirm you opened Apps → Quizzes from the SWAI Dashboard for the right brand.
2. Confirm Save vs Publish: drafts are not live until you Publish.
3. Check whether the step needs brand assets, a webinar, a nurturing assistant, CRM lists, or Page Builder Show Quiz.
4. Note any exact toast or screen message (for example Quiz not found, publish/save failures), the quiz title, and whether you were on the list, Build, Results, Design, Preview, or using the AI assistant.
5. Contact your SWAI admin or support with those details.

Related Help: Page Builder, Campaign Builder, File Library, Webinar, Conversational Agents, CRM, Notifications.