Docs

Question Blocks

QuizFlow Labs supports a focused set of question blocks designed for fast completion and clean reporting.

Quiz flow

Complete the Quiz Details step first so the quiz has a name, slug, description, and optional header. After you finish Questions, head to the Completion Step to compose the final card and toggle the score/response controls.

This guide will walk you through:

The question blocks you can add today
Validation rules (what is required)
Common tips for better completion rates

When to use this

Use this when deciding which question type best fits the signal you need.

How it works

Text: open-ended response (short and long text are saved as text). You can optionally assign points by enabling the new Answer Key so exact matches award the configured score.
Multiple Choice: single-select by default, with optional multi-select.
Choice Buttons: quick, chat-style choices with compact labels.
Yes/No: binary decisions for key qualifiers.
Scale: numeric scale with optional labels.
Cards Step: one or more rich cards with optional per-card CTA buttons.
YouTube Step: embed a single YouTube video with an optional CTA label.

Coming soon

Ranking is listed in the builder but currently disabled.

Question types

Note

Screenshot coming soon.

Step-by-step

Open a quiz and go to the Questions step (Question Blocks).
Select a question block from the left panel.
Enter a clear prompt and fill in any options or labels.
Drag blocks to reorder the flow.

Multiple Choice usage

Add a Multiple Choice block from the Question Blocks panel.
Write a clear prompt that tells respondents what to choose.
Add at least two options (remove or reorder as needed).
Pick a Selection mode: single select (default) or multiple select.
If using multiple select, set optional minimum and maximum selections.
Toggle Required if you need at least one selection before continuing.

Multiple Choice settings

Selection mode

Single select (default): respondents can pick one option.
Multiple select: respondents can pick more than one option and toggle them on/off.

Selection limits (multiple select only)

Minimum selections (optional): requires at least X options before continuing.
Maximum selections (optional): caps how many options can be selected.

If a question is marked Required, multiple select enforces a minimum of 1 even if you leave the minimum blank.

Participant experience

Single select: picking a new option replaces the previous choice.
Multiple select: selections can be toggled; the quiz prevents selecting more than the max and blocks continue until the minimum is met.

Scoring (Multiple Choice, Choice Buttons, Yes/No)

Toggle Scoring to assign integer points to each option (default is 0).
Scores can be negative and are summed across selected options.
Multi-select questions add all selected option scores.
Yes/No questions let you set separate scores for Yes and No.
Scoring is available on Basic and higher plans.
Points are always whole numbers between -9,999 and 9,999, and the builder clamps any value outside that range automatically.
The total score shown in completion copy or rules is the sum of every scored option (including every choice in multi-select questions) plus the numeric value submitted on scale questions.
Scale questions contribute their raw numeric response directly, so a 1–5 scale answer worth 4 adds 4 points.
Completion copy can embed {{total_score}}, and the completion step lets you toggle whether to Display total score plus whether to show full responses on the report card; scores only appear if you enable that checkbox.
Ordered completion rules evaluate the total score when enabled (Pro plan) and stop at the first matching rule, so make sure the ranges or operators are listed from most specific to broadest.
Text questions gain a built-in Answer Key. Toggle “Use Answer Key for scoring,” type one accepted answer per line, and pick a point value between -9,999 and 9,999 (default 1). The builder trims whitespace, ignores case, and awards the configured points only when the submitted text matches a listed answer exactly; every other response adds 0. Answer Key scoring follows the same “shown + answered” rules as other scored questions.

Tags & personalization

Multiple Choice and Choice Button options offer a Tag (optional) selector on every option card. Pick an existing tag (they are stored as custom variables) or use the + Create new tag... choice to open the variable form. The builder records each unique tag for multi-select answers, and Yes/No blocks expose a Response tags card with Yes tag and No tag selectors that fall back to the literal label when left empty.

The {{tag:<questionId>}} and {{tags:<questionId>}} placeholders surface those values in completion copy, thank-you messages, and any field that supports the Insert Tag (VariablePicker) button. See the Response Tags guide for how those placeholders resolve and how tags travel through submissions and derived variables.

Cards Step usage

Add a Cards Step block from the Question Blocks panel.
Add between 1 and 10 cards and fill in at least one of: image, title, or description.
Use Display mode to choose auto, single, or carousel.
Optional: enable Button (optional) per card to add a CTA link.
Use Continue button to customize the step CTA label.