Checkbox
The Checkbox element lets users select multiple options from a 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 Checkbox element, managing the options in the checkbox list. Each option consists of two parts:
- Label (display text): The text users see in the checkbox list
- Value (submitted value): The value actually sent when the form is submitted
Label vs Value
For example, when the Label is "Soccer", the Value can be set to soccer. Users check "Soccer", but soccer 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:
| Button | Description |
|---|---|
| ✓ (Default value) | Set as the default checked 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, the following are available:
- Add option: Add a single blank option
- Add bulk options: Add many options at once
Description
Explanatory text displayed beneath the field, providing help information.
Validate
The Checkbox element supports the following validation rules:
| Validator | Description |
|---|---|
| Required | Marks the field as required, ensuring the user has checked at least one option |
| Minimum checkbox | The minimum number of options that must be checked |
| Maximum checkbox | The maximum number of options that can be checked |
Limiting the number of selections
For example, setting Minimum checkbox to 2 and Maximum checkbox to 4 means the user must check 2-4 options to pass validation.
Styles
Configure the element's display style.
Options layout
The arrangement of the checkbox options. Available options:
- Inline: Options are arranged in a single row (default)
- One option per line: Each option is on its own line
- 2 columns ~ 10 columns: Options are arranged in a 2-10 column grid
Layout suggestions
Use Inline or One option per line when there are few options; use a multi-column layout when there are many options to save space.
Label position
Controls where the label appears. Available options:
- Inherit: Uses the global configuration in Form style settings
- Vertical: The label appears above the options
- Horizontal: The label appears to the left of the options
- Hidden: The label is not displayed
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:
| Part | Description |
|---|---|
| Field | Select a target field from the dropdown (displays 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 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
For example, when the user checks "Other" under "Hobbies", show a text box for the user to provide details:
- Match mode: Match any condition
- Field: Hobbies
- Operator: is
- Value: Other
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 checks the matching options.
For example, if you enter hobbies in Parameter name, and the user visits the form at:
https://yoursite.com/contact?hobbies=soccer,readingthe options with Value soccer and reading are automatically checked.
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 Checkbox element's values come from preset options and need no filter pre-processing, so the Advanced tab does not contain Filters.
Next steps
- Radio buttons — Single selection
- Multiselect — Dropdown multi-select
- Select — Dropdown single-select