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 needs no filter pre-processing, 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 listDropdown expand
Fields Height✅ Configurable
Search✅ (with Display Search enabled)
Best forFew optionsMany optionsMany options + aesthetic needs

Next steps

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

Built with VitePress