Skip to main content
Choice questions let respondents select from a predefined set of options. Most types share a common option editor; each type adds its own specific settings on top.

​
Shared option editor

Multiple choice, Checkbox, Dropdown, Ranking, and Picture choice all use the same option list editor. Option list behaviour:
  • Click Add option to append a new option (labeled “Option N”).
  • Editing a label automatically rewrites the option’s internal value to a lowercase underscore slug (e.g. “Very satisfied” → very_satisfied).
  • Options can be reordered by drag.
  • Removing an option clamps min_selections and max_selections down to the new option count if they would exceed it.
Shared fields:
FieldTypeDefaultNotes
optionsList2 optionsEach option has a label, value, and optional image
randomizeBooleanfalseShuffles option order for each respondent
layout_alignmentEnumverticalvertical · horizontal · grid (hidden for Dropdown)

​
Multiple choice

Respondents select one option from a list. Multiple choice question in the canvas
FieldTypeDefaultNotes
allow_otherBooleanfalseAdds a free-text “Other” option
other_labelText—Label shown next to the Other input
other_placeholderText—Placeholder inside the Other text field

​
Checkbox

Respondents select one or more options from a list.
FieldTypeDefaultNotes
min_selectionsNumber1Minimum options that must be selected (0–option count)
max_selectionsNumber2Maximum options that can be selected (1–option count)
allow_otherBooleanfalseAdds a free-text “Other” option
other_labelText—Label for the Other option
other_placeholderText—Placeholder inside the Other text field
Respondents select one option from a collapsed dropdown menu. Best for long option lists or when space is limited.
FieldTypeDefaultNotes
placeholderText—Hint text shown before a selection is made
allow_otherBooleanfalseAdds a free-text “Other” option at the end of the list
randomizeBooleanfalseShuffles option order
layout_alignment is not applicable to Dropdown — options always appear in a vertical list inside the dropdown menu.

​
Yes / No

A binary choice with two clearly labelled buttons. Best for simple agree/disagree or yes/no questions.
FieldTypeDefaultNotes
labels_binary.yesTextYesLabel on the Yes button
labels_binary.noTextNoLabel on the No button
show_iconsBooleantrueShows emoji icons on the buttons
icons_binary.yesEmoji👍Icon shown on the Yes button
icons_binary.noEmoji👎Icon shown on the No button
layout_alignmentEnumhorizontalhorizontal or vertical button layout

​
Picture choice

Respondents choose from options that each have an image. Best for visual product selection, mood boards, or any question where images communicate better than words.
FieldTypeDefaultNotes
multiple_selectionsBooleanfalseAllows selecting more than one option
min_selectionsNumber—Minimum selections (visible when multiple_selections is on)
max_selectionsNumber—Maximum selections (visible when multiple_selections is on)
show_labelsBooleantrueShows the text label beneath each image
image_aspect_ratioEnumsquaresquare · landscape · portrait
image_fitEnumcovercover (crop to fill) · contain (letterbox)
randomizeBooleanfalseShuffles option order
layout_alignmentEnum—vertical · horizontal · grid
Each option has an individual image upload in the option editor.

​
Ranking

Respondents drag options into their preferred order. Best for priority surveys or preference ranking.
FieldTypeDefaultNotes
optionsList3 optionsEach option has a label and value
randomizeBooleanfalseShuffles initial option order
layout_alignmentEnum—Layout for ranking items
The answer to a Ranking question is stored as an ordered array of option values — e.g. ["option_b", "option_a", "option_c"].

​
Next steps

Rating questions

Star, number scale, emoji, and opinion scale.

Conditional branching

Route respondents based on which option they selected.