Skip to content

Email ​

The Email element lets users enter an email address, with built-in email format validation.

Basic ​

Configure the element's basic 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

TIP

The Label is user-facing display text. Keep it concise and easy to understand.

Unique Name ​

Identifies this element 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.

Unique Name vs Label

The Label is display text shown to users, while the Unique Name is the internal system identifier. For example, the Label could be "Your Email", while the Unique Name could be user_email.

Description ​

Explanatory text displayed beneath the field to help users know what to enter.

Placeholder ​

A short hint displayed in the field before the user enters input, describing the expected value. It disappears automatically once the user starts typing.

Placeholder vs Description

  • Placeholder: Shown inside the input box, disappears after input. Best for short hints (e.g., "Please enter your email address")
  • Description: Shown beneath the input box, always visible. Best for detailed explanations

Field icon ​

Add an icon to the input box to enhance the form's visual appeal and user experience.

Validators ​

Validators check user input against a set of rules. The Email element has the Email validator added by default to ensure the user enters a valid email address.

ValidatorDescription
RequiredMarks the field as required, ensuring it is filled in
EmailChecks whether the value is a valid email address (added by default)
EqualsChecks whether the value equals the specified string
CustomValidates using a custom regular expression

Styles ​

Configure the element's display style. These options override this element's style without affecting other elements.

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 side of the input box
  • End: The icon appears on the right side of the input box

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

Only show the "Email" field when the user selects "Email" for "Contact method":

  • Match mode: Match any condition
  • Field: Contact method
  • Operator: is
  • Value: Email

Data ​

Configure the element's default value and input behavior.

Default value ​

The field's default value. Pre-filled when the user opens the form.

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 fills it into the field automatically.

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

https://yoursite.com/contact?email=user@example.com

the field is automatically filled with the value user@example.com. If the URL has no email parameter, the field is empty (or uses the default value set in Default value).

Use cases

  • Source tracking: Record which channel a user came from via URL parameters on different ad links
  • Pre-fill form: Automatically fill in known user information when users arrive from other pages
  • A/B testing: Display different default values based on URL parameters

Maximum length ​

The maximum number of characters allowed for input.

Read only ​

Makes the field read-only so the user cannot edit it. Suitable for displaying fixed information or pre-filling via a dynamic default value.

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 element's unique ID, auto-generated by the system. Read-only.

Filters ​

Filters pre-process input before the user submits. The Email element has the Trim filter added by default.

FilterDescription
TrimRemoves leading and trailing spaces from the value (added by default)

Use in email notifications ​

The Email element's value can be used as a recipient variable in email notifications. For example, when sending a confirmation email to the form submitter, insert the Email field variable.

Next steps ​

Built with VitePress