Multiple choice
The Multiple choice element shows a set of predefined options that visitors pick from, with single or multi-select. Use it for product options, preferences, quiz questions, or extra services where the answer fits a fixed list rather than free text.
Properties
The properties live in the inspector under the Multiple choice group. Several fields appear only when the property that enables them is on.
Property | What it does | Default |
|---|---|---|
Show images | Shows an image for each option | No |
Show labels | Shows the option label; appears only when Show images is Yes | Yes |
Show captions | Shows the caption under each option | Yes |
Show values | Shows each option's value | No |
Options set-up | Static records or a Formula that produces the option table | Three records: Option #1, Option #2, and Option #3, each with value 1, 2, and 3 and caption "This is an optional caption." |
Default option | Option selected when the element loads; a select list for static records, a formula field for Formula | No default |
Multiselect | Lets visitors pick more than one option | Off |
Allow deselect | Lets visitors clear a chosen option; appears only when Multiselect is off | Off |
Disabled | Prevents visitors from changing the selection | Off |
Required | Requires an answer before continuing | Off |
Go to next view when answered | Advances to the next view once answered; hidden when Multiselect is on | Off |
Logic | Controls whether the whole element is shown, based on a Visibility formula | Always |
In Options set-up, each record has a Label and a Value. The Image field appears only when Show images is Yes, and the Caption field only when Show captions is Yes. When Options set-up is a Formula, the element reads a Label column, a Value column, an Image column, and a Caption column from the produced table; the Image and Caption columns appear only when the matching visibility is on. The Value column can be left empty to number the options 1, 2, 3, and so on. There is no global default for Default option, Allow deselect, or the image value.
References
References expose the visitor's answer as data you can use in formulas and other elements. Assign a reference to store the multiple choice answer in a variable.
Value: the selected value or values.
Label: the selected label or labels.
Count: the number of selected options.
Touched: whether the visitor has made a selection.
Matrix: the options and their selected state.
Last touched at: when the visitor last changed the selection.
Styling
The Multiple choice element can be styled per state and per part of the element.
Style states: Active, Checked, Default, Disabled, Error, Focus, Hover.
Named targets: wrapper, item, item-body, image, radio, checkbox, body-content, label, caption, value, error-label.
Named styles: Multiple choice, Multiple choice - cards, Multiple choice - stacked cards brand background, Multiple choice - stacked cards white background, Multiple choice - list with dividers, Multiple choice - table, Multiple choice - table bordered.
Apply general styling from the Style tab: quick styles, style sets, and CSS overrides per state and per breakpoint. The quick styles are Columns, Gap, Orientation, Outline shape, Object fit, Aspect ratio, and Radio Placement. The image-related quick styles, Orientation, Outline shape, Object fit, and Aspect ratio, appear only when Show images is Yes.
Related articles
UI Elements: overview of the elements.
FormulaScript Overview: using formulas in properties.