Docs

Quiz Structure

Every quiz follows a simple structure: details (including optional Bio Funnel), question blocks, optional lead capture, completion, interface settings, then finish. Jump Logic can route respondents to later steps based on answers.

This guide will walk you through:

  • The building blocks of a quiz
  • Where to edit each part
  • How completion messaging works

When to use this

Use this when you want a mental model for where content lives in the builder.

How it works

  • Details include title, slug, Quiz Intro Message, and optional banner image.
  • Bio Funnel Builder (inside Intro & Bio Funnel) can render a pre-start page at /q/{slug} before respondents enter the quiz. See Bio Funnel Builder. For practical conversion patterns, use the social bio routing guide.
  • Question blocks are ordered blocks (multiple choice, dropdown, yes/no, scale, slider, text, card/carousel step, product cards, YouTube step).
  • API Step is an optional server-side request step that can send data to external tools, capture response variables, and route failures; see the API Step guide.
  • Agent Step is an optional AI block that runs after the questions. Use it to surface GPT-generated cards, set structured variables, or route respondents before completion; see the Agent Step guide for details.
  • Jump Logic (Pro) can route respondents to later questions, lead capture, or completion based on their answers.
  • Lead capture is a special block that can be added before completion.
  • Completion is where you write the completion message, control whether the total score or responses are visible, and add completion rules (variable-based, plus score-based on Pro).
  • Interface Settings is where you configure hosted/embed presentation before publish.
  • Finish is where you publish and share the quiz.

Completion privacy control

Use the Display responses switch while editing the completion message to choose whether the report card lists every question and answer; toggle it off to keep submissions private while still showing the completion copy and optional score.

Quiz structure

Step-by-step

  1. Start in Details to name the quiz and set the public slug.
  2. Use Continue to questions to move forward.
  3. Add question blocks in order.
  4. Optionally add an API Step to call external services, capture response values, and define a failure fallback; refer to the API Step guide for setup details.
  5. Optionally add an Agent Step to run AI instructions, set variables, or route respondents before lead capture or completion; refer to the Agent Step guide for configuration tips.
  6. Add a Lead Capture block if you need contact details.
  7. Use Continue to completion to set the completion message.
  8. Use Continue to interface to configure presentation and embeds.
  9. Use Continue to finish to review status and publish.

Tips / Gotchas

  • Jump Logic is Pro-only and forward-only.
  • Completion copy, score display, and banner images are disabled on free plans.
  • Score-based completion rules require the Pro plan; variable-match completion rules are available more broadly.
  • Disable Display responses when you prefer to keep the answer list private; respondents still see the completion title and message.
  • If you have unsaved changes, you will be prompted before continuing.