Docs

Multiple Choice block

Use this block when you need ordered choices, optional scoring, tags, variable-driven routing, or visual image choices. Multiple Choice supports single-select by default and can flip to multi-select with min/max limits.

If you need respondents to explicitly order preferences, use the dedicated Ranking block guide.

How to use it

  1. Add a Multiple Choice block from the Question Blocks palette.
  2. Write a clear prompt and enter at least two choices (or use Bulk paste to import a list).
  3. Open the Multiple Choice settings panel (the cog next to the choices list) to manage required responses, scoring, selection mode, style, labels, randomization, and Jump Logic.
  4. Dial in min/max selection limits, styling, scoring, and routing before you publish so the block enforces your design and logic.

Multiple Choice settings panel

Click the Settings button with the cog icon on the question card to slide the panel out from the right. It now houses every control that belonged to the block: the Required response toggle at the top, the Scoring toggle and optional Answer Key helpers, the Selection mode dropdown with min/max inputs, the Style section with layout, label, and randomization settings, and the Jump Logic button at the bottom. Each question has its own panel so you can style and route blocks independently.

Selection settings

  • Single select (default): One choice at a time. The dropdown lives in the settings panel you opened in Step 3.
  • Multiple select: Flip the panel's toggle to allow multiple choices, then set Min selections and Max selections from the inputs that appear. Required questions automatically keep Min selections at 1 so respondents can never skip the block.
  • Required response: The toggle at the top of the panel ensures respondents cannot continue without choosing something, even when min/max are unset.
  • Ranking style: If you switch Style to Ranking, use the dedicated Ranking block settings pattern (Rank all vs Top N).

Scoring & totals

  • Toggle Scoring inside the Multiple Choice settings panel (Basic and higher) to assign integer points per option; negatives and zero are allowed. Enabling scoring also reveals the Answer Key (optional) controls, so you can mark correct choices without leaving the panel.
  • Use the Set scores for a standard test (Correct = 1, Incorrect = 0) link to reset the scores based on the currently marked answer key. The panel still honors any manual scores you enter, and it reminds you if every option score remains zero so totals will not actually change.
  • Enable Immediate feedback (inside the same Answer Key area) if you want respondents to see right/wrong feedback instantly after answering. Builders can choose per-state indicators for correct and incorrect (check, X, not quite, custom text, or none) plus animation style.
  • Multi-select answers sum every selected option score, and the totals feed completion rules, Jump Logic, and the {{total_score}} placeholder. See the Scoring Logic guide for details on how totals resolve in completion copy and rules.

Bulk paste options

Use Bulk paste in the Options row when you want to import many choices at once.

  • Supported formats:
    • One label per line
    • Tab-separated rows
    • CSV rows
  • Column mapping: label, optional tag, optional integer score
  • Tag behavior: Missing tag variables are auto-created as custom text variables during import.
  • Tag validation: Tag keys must start with a lowercase letter and use only lowercase letters, numbers, and underscores. Invalid tag keys are skipped.
  • Score behavior: Scores import only when the question's Scoring toggle is on. If scoring is off and score values are detected, the dialog warns you and lets you enable scoring before import.
  • Replace behavior: Replace all options resets the question's Answer Key. If an answer key is currently selected, you will be asked to confirm before replacing.

Style & layout

The Style section in the settings panel decides how each choice renders. The variant dropdown offers:

  • Classic (radio/check): The default list that uses radios for single-select and checkboxes for multi-select.
  • Button: Pill-style buttons that react quickly to taps.
  • Dropdown: Compact single-select menu style (also available as a dedicated Dropdown block in the palette).
  • Card rows: Full-width cards with subtle borders, ideal for longer option copy.
  • Tile / grid: A grid layout that highlights each choice equally.
  • Media card: A visual image choice layout where each option can include an image, alt text, and image position.

Image choice quizzes (Media card)

If you want respondents to pick a picture instead of plain text, set Style to Media card and add per-option media in the Options list (upload your own image or choose a GIF).

  • How to enable: Open block Settings, switch Style to Media card, then return to Options.
  • Per-option media controls: Upload image or click Search GIFs, set optional alt text, choose position (Large top (card image), Top, or Left).
  • GIF source: The GIF picker searches GIPHY directly from the editor and applies the selected GIF to that choice.
  • Default image position: New uploads default to Large top (card image) so visual choices feel card-sized out of the box.
  • Upload limits (local files): JPG, PNG, and WebP only; up to 10 MB source file; auto-compressed to max 1200px side; must be 500 KB or smaller after compression.
  • GIF behavior: GIFs are selected through the built-in picker and stored as secure https media URLs.
  • Validation behavior: Invalid files are blocked immediately during upload so editors can fix media before saving.

For a complete workflow, see How to create an image choice quiz.

For a complete ecommerce workflow, see How to build a product recommendation quiz.

Choosing any preset besides Classic reveals additional layout controls:

Layout controls

  • Orientation: Auto lets the system decide vertical or horizontal alignment, while the explicit presets force the stack you need.
  • Columns: Auto stays responsive; pick 1-4 columns to lock how many cards share a row.
  • Width behavior: Default respects the variant, Fit content shrinks each choice to its text, and Full width stretches the tiles to fill the column.
  • Density: Default, Comfortable, or Compact spacing keeps the gaps between options loose or snug.

Labels & randomization

  • Labels: Choose None, Alpha, or Numeric badges to make referencing options easier in instructions or Jump Logic rules.
  • Randomization: None preserves the order, Randomize all shuffles every load, and Randomize except pinned keeps pinned options fixed while the rest reshuffle.

Responsive tagging

  • Every option lets you assign a Tag (optional). Tags feed placeholders like {{tag:<questionId>}} and {{tags:<questionId>}} that you can insert into completion copy, automations, or exports.
  • The tags you choose act as custom variables, so they show up in the variable picker across blocks.
  • Reference the Response Tags guide for placeholder syntax and runtime behavior.

Jump Logic & routing

  • Jump Logic lives behind the Logic button at the bottom of the Multiple Choice settings panel. Tap it to add rules that check option values, tag-driven variables, or derived values, and send respondents to any later question, the lead capture step, or completion. The button is disabled with an upgrade hint on non-Pro plans.
  • Rules run top-to-bottom, so put the most specific destinations first.
  • Logic rules can reference the same custom variables you surface in scoring or completion copy. Learn more in the Logic & Branching guide.

Tips

  • Use the style, label, and randomization controls inside the settings panel to match your brand and keep option layouts tight or airy.
  • For visual product matching, use Media card with short labels and consistent image framing (same aspect ratio across options).
  • Clear option labels keep Jump Logic readable.
  • Use tags to expose the respondent's signal everywhere, not just here.
  • When you need GPT to set future variables before completion, pair this block with the Agent Step.