Skip to content

Select

The Select element lets users choose a single option from a dropdown list.

Basic

Configure the element's fundamental properties.

Label

The label text displayed above or beside the field (depending on the Label position setting). It also:

  • Identifies the field in the admin interface
  • Displays as a heading in the form preview panel on the right

Unique Name

Identifies this form element internally within the system. The name is auto-generated by default, but you can modify it as needed. Naming rules:

  • May only contain lowercase letters, numbers, and underscores
  • Must start with a letter

This name references the field in email templates.

Options

The core configuration of the Select element, managing the options in the dropdown list. Each option consists of two parts:

  • Label (display text): The text users see in the dropdown list
  • Value (submitted value): The value actually sent when the form is submitted

Label vs Value

For example, when the Label is "Mainland China", the Value can be set to cn. Users see "Mainland China", but cn is submitted.

By default, the Value matches the Label (the Value input box is disabled). Enable the Customize values toggle to set a Value different from the Label for each option individually.

Option operations

Each option provides the following 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 adjust the order of options

Add options in bulk

In addition to adding them one by one, three bulk operations are available:

  • Add option: Add a single blank option
  • Add optgroup: Add an option group (optgroup) to group multiple options under one group heading
  • Add bulk options: Add many options at once

"Please select" option

Whether to display a "Please select" prompt at the top of the dropdown list (enabled by default). This prompt has no Value and is not submitted; it appears only as the first item in the list.

Working with Required validation

The "Please select" prompt ensures the user makes an active choice. Combined with the Required validator, since the prompt has no value, the user must actively select a real option from the list to pass validation, preventing an empty submission.

Please select text

The display text for the "Please select" prompt (e.g., "Please select", "Please select a country").

Description

Explanatory text displayed beneath the field, providing help information.

Label Icon

Add an icon to the field label.

Validate

The Select element supports only one validation rule:

ValidatorDescription
RequiredMarks the field as required, ensuring the user has selected an option

Styles

Configure the element's display style.

Label position

Controls where the label appears. Available options:

  • Inherit: Uses the global configuration in Form style settings
  • Vertical: The label appears above the input box
  • Horizontal: The label appears to the left of the input box
  • Hidden: The label is not displayed

Icon position

Controls where the icon appears. Available options:

  • Inherit: Uses the global configuration
  • Start: The icon appears on the left
  • End: The icon appears on the right

Logic

Enable conditional logic

When enabled, you can 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 set the rule match mode:

  • Match any condition (any): The element shows or hides as long as any one rule is satisfied
  • Match all conditions (all): The element shows or hides only when all rules are satisfied

Configure rules

Each rule consists of three parts:

PartDescription
FieldSelect a target field from the dropdown (displays 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 the Add logic rule button to add a new rule
  • Click the 🗑 button to the right of each rule to delete it
  • Click the button to add more match conditions

Example

Select is often used as a trigger condition. For example, only show the "Province" field when the user selects "China" in "Country":

  • Match mode: Match any condition
  • Field: Country
  • Operator: is
  • Value: China

Data

Dynamic default value

When enabled, a Parameter name input box appears. Enter the name of a URL parameter, and the system reads that parameter's value from the URL and automatically selects the matching option.

For example, if you enter country in Parameter name, and the user visits the form at:

https://yoursite.com/contact?country=cn

the dropdown list automatically selects the option with Value cn.

Show in email

Whether this field's value appears in the email notifications (enabled by default). When disabled, the field's value is not included in the submission email.

Advanced

Unique ID

The unique ID of the element, auto-generated by the system, read-only and not editable.

No filters

The Select element's values come from preset options and need no filter pre-processing, so the Advanced tab does not contain Filters.

Next steps

Built with VitePress