Skip to content

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:

ButtonDescription
✓ (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:

ValidatorDescription
RequiredRequires 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:

PartDescription
FieldPick a target field from the dropdown (shows the field's Label)
OperatorThe comparison condition
ValueThe target value to compare against

Supported operators ​

OperatorDescription
isTriggers when the field value equals the specified value
is notTriggers when the field value does not equal the specified value
is emptyTriggers when the field value is empty
is not emptyTriggers 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,reading

then 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 requires no filtering, so the Advanced tab has no Filters.

Multi-select elements comparison ​

FeatureCheckboxMultiselectSelect Menu (Multiple enabled)
Selection methodCheckboxesList box (Ctrl/Command multi-select)Chip-style tags
Options layoutConfigurable (Inline/columns)Fixed listExpandable dropdown
Fields Height❌✅ Configurable❌
Search❌❌✅ (with Display Search enabled)
Best forFew optionsMany optionsMany options + visual polish

Next steps ​

  • Checkbox — Checkbox multi-select
  • Select Menu — Enhanced dropdown with multi-select option
  • Select — Dropdown single-select

Built with VitePress