Forms & Quizzes
Create a Quiz
Build a multi-step interactive quiz using the SuperAgent — with conditional logic, validation, animations, and integrations.
Overview
Quizzes are multi-step interactive flows that qualify leads and collect richer data than a standard form. They can act as standalone pages or be embedded within a page.
SuperFunnel quizzes support a wide range of features beyond basic field collection:
- Conditional logic — branch visitors to different steps based on their answers, or disqualify them early if they're not a good fit
- Animations — add visual transitions and animated elements between steps
- API validation — connect to external APIs to validate lead data in real time, such as confirming a phone number or verifying an address before capturing the lead or sending it downstream
- Custom result logic — use visitor input to generate and display personalised results
- Query parameters and storage — pass data in via URL query parameters, or read from local or session storage to pre-fill steps, skip steps the visitor has already completed, or carry context from a previous interaction
Capture partial leads
Ask for an email address or phone number in an early step so SuperFunnel can capture a partial lead even if the visitor drops off before completing the quiz.
Create the Quiz
Open the SuperAgent
1a. Click SuperAgent in the left sidebar to open it directly.
1b. Alternatively, click Quiz Funnels in the left sidebar, then click + New Quiz Funnel.
Describe the quiz
In the chat input, describe the quiz you want to build.
Once you've entered and sent your description, allow the SuperAgent a few minutes to build out the quiz — especially if it is complex or has multiple routing paths.
How to write a strong quiz prompt
Focus first on the fields you want to collect, then layer in the details:
- Which fields are mandatory and which are optional
- Which fields need validation — for example, a phone number field can use built-in regex validation, and additional custom validation rules can be added on top
- Any conditional logic — such as routing visitors down different paths based on an answer, or disqualifying them if they don't meet a threshold
- Specific steps or screens you want included, such as a social proof screen or a loading animation before the results
Example:
Create a quiz that collects first name (required), company name (required), company size (required), monthly traffic (required), and phone number (required with validation). Add a social proof screen before the phone number step. If company size is under 10 employees, disqualify the lead and show a "not a fit" message.
Add final steps
Before reviewing the quiz, add the endpoint experiences visitors will reach — either on completion or when disqualified. These are essential to a working quiz flow.
Final Steps power your conversion count
Reaching a Final Step is what fires the superfunnel-form-submission event.
A quiz or form without a Final Step records everyone as a
partial lead
and reports 0 form submissions. See
Default conversion events.
If you are not using the agent to build the final steps for you, you can add them manually.
To redirect the user:
- Click Add Step → Final Step → Redirect
- Click the edit icon and enter the destination URL
To enter Custom HTML for a final step:
- Click Add Step → Final Step → HTML
- Click the edit icon and add your HTML content
Common final step experiences:
-
Disqualify — show a message and stop the flow for visitors who don't meet your criteria (e.g. wrong company size, invalid location). Set disqualification conditions on any step.
-
Thank you screen — a simple confirmation screen acknowledging the visitor's submission. Useful when no further action is needed from the visitor.
-
Coupon or offer — display a discount code or special offer to reward quiz completion and encourage an immediate purchase or booking.
-
Custom results — use the visitor's answers to display a personalised outcome, recommendation, or score at the end of the quiz.
-
Redirect to a URL — send the visitor to another page after completing the quiz (a booking page, your main site, or a confirmation page):
Test redirects
Test redirects in a live production environment — not inside the SuperFunnel app. Browsers may block redirects triggered within the editor, giving a false negative. Always verify the redirect works by going through the quiz on the published staging or production URL.
Review the generated quiz
Go through the quiz yourself from start to finish. If your quiz has conditional routing, test each path separately to confirm every branch reaches the correct final step.
If the quiz is connected to an integration such as HubSpot or a webhook, also test it in a live production environment and verify:
- Results are sent to the correct destination
- Field values are mapped correctly and look right on the receiving end
- Partial leads (if configured) are also captured and sent
You may need to adjust quiz logic, field names, or integration settings after your first test.
Publish changes
At the top of the quiz editor click the Publish dropdown. Enter a version name and (optional) description of changes. Click Publish Changes to push your staging version to live.
Embed the Quiz in a Page
A quiz can be embedded directly inside a page so visitors interact with it without leaving the page flow.
Note the quiz name
Go to Quiz Funnels from the left sidebar and copy the exact name of the quiz you want to embed. You will use this name in the next step.
Open your page
Go to Pages from the left sidebar and open the page where you want the quiz to appear.
Add the quiz via the SuperAgent
In the page editor, open the SuperAgent chat and type:
Add the quiz funnel [Quiz Name] to the page
The SuperAgent will insert the quiz into the page automatically — no manual embedding or code required.
Review and publish
Review the page layout, then click Publish in the top-right corner to make the page live.
Convert to Form
If you do not need a direct link to a quiz and want to embed it inside a page instead, use the Convert to Form option. You can find it by clicking the vertical ellipsis (⋮) next to the quiz in the Quiz Funnels list.
Embedded forms can be multi-step and preserve all the fields and logic of the original quiz — the key difference is that they are designed to live inside a page rather than exist as a standalone URL.
Where to find embedded forms
Embedded forms can be found in Settings > Embedded Forms after conversion.