Multiselect
The Multiselect element lets users select multiple options from a list box. Users can hold Ctrl (Windows) or Command (Mac) to make multiple selections.
Basic
Basic settings define the element's core properties.
Label
The label text shown above or beside the field (depending on the Label position setting). It also:
- Helps identify the field in the admin interface
- Appears as a heading in the form preview panel on the right
Unique Name
The internal identifier for this element. The name is auto-generated by default, but you can edit it manually. Naming rules:
- Lowercase letters, numbers, and underscores only
- Must start with a letter
This name references the field in email templates.
Label vs. Unique Name
The Label is the text shown to users, while the Unique Name is the internal identifier. For example, the Label could be "Hobbies" and the Unique Name hobbies.
Options
The core configuration of the Multiselect element, managing the options in the list. Each option has two parts:
- Label (display text): The text users see in the list
- Value (submitted value): The value sent on submission
Label vs. Value
For example, the Label could be "Soccer" and the Value soccer. Users see "Soccer", but soccer is submitted.
By default, the Value matches the Label (the Value input is disabled). Enable the Customize values toggle to set a different Value for each option.
Option operations
Each option provides these action buttons:
| Button | Description |
|---|---|
| ✓ (Default value) | Set as the default selected option |
| 🗑 (Remove) | Delete this option |
| + (Add) | Add a new option below |
| 📄 (Duplicate) | Duplicate this option |
| ≡ (Sort) | Drag to reorder options |
Add options in bulk
Beyond adding options one by one, three bulk operations are available:
- Add option: Add a single blank option
- Add optgroup: Add an option group (optgroup) to group several options under one heading
- Add bulk options: Add many options at once
Description
Explanatory text shown beneath the field, providing help and context.
Label Icon
Adds an icon to the field label.
Validate
The Multiselect element supports a single validation rule:
| Validator | Description |
|---|---|
| Required | Requires the user to select at least one option |
Styles
Style settings control the element's appearance.
Fields Height
The height of the multi-select list box, in pixels (default 100, minimum 1). This determines how many options are visible without scrolling.
Height suggestions
With many options, increase Fields Height (e.g., 150-200) so users see more without frequent scrolling.
Label position
Controls where the label appears. Available options:
- Inherit: Uses the global configuration in Form style settings
- Vertical: Label above the list box
- Horizontal: Label to the left of the list box
- Hidden: Label hidden
Icon position
Controls where the icon appears. Available options:
- Inherit: Uses the global configuration
- Start: Icon on the left
- End: Icon on the right
Logic
Enable conditional logic
When enabled, configure rules to show or hide this element based on the user's input in other fields.
Rule match mode
After enabling conditional logic, first choose the match mode:
- Match any condition (any): The element shows/hides when any single rule is satisfied
- Match all conditions (all): The element shows/hides only when all rules are satisfied
Configure rules
Each rule has three parts:
| Part | Description |
|---|---|
| Field | Pick a target field from the dropdown (shows the field's Label) |
| Operator | The comparison condition |
| Value | The target value to compare against |
Supported operators
| Operator | Description |
|---|---|
| is | Triggers when the field value equals the specified value |
| is not | Triggers when the field value does not equal the specified value |
| is empty | Triggers when the field value is empty |
| is not empty | Triggers when the field value is not empty |
Add and manage rules
- Click Add logic rule to add a new rule
- Click the 🗑 button on the right of a rule to delete it
- Click the + button to add more match conditions
Example
For example, show the "Children's hobbies" multi-select field only when the user selects "Yes" for "Do you have children":
- Match mode: Match any condition
- Field: Do you have children
- Operator: is
- Value: Yes
Data
Dynamic default value
When enabled, a Parameter name input appears. Enter the name of a URL parameter, and the system reads that value from the URL and auto-selects the matching options.
For example, if you enter hobbies in Parameter name and the user visits:
https://yoursite.com/contact?hobbies=soccer,readingthen the options with Value soccer and reading are auto-selected.
Show in email
Controls whether this field's value appears in the email notifications (enabled by default). When disabled, the field's value is excluded from the submission email.
Advanced
Unique ID
The element's unique ID, auto-generated by the system. Read-only.
No filters
The Multiselect element draws its values from preset options and needs no filter pre-processing, so the Advanced tab has no Filters.
Multi-select elements comparison
| Feature | Checkbox | Multiselect | Select Menu (Multiple enabled) |
|---|---|---|---|
| Selection method | Checkboxes | List box (Ctrl/Command multi-select) | Chip-style tags |
| Options layout | Configurable (Inline/columns) | Fixed list | Dropdown expand |
| Fields Height | ❌ | ✅ Configurable | ❌ |
| Search | ❌ | ❌ | ✅ (with Display Search enabled) |
| Best for | Few options | Many options | Many options + aesthetic needs |
Next steps
- Checkbox — Checkbox multi-select
- Select Menu — Enhanced dropdown with multi-select option
- Select — Dropdown single-select