Skip to content

Text

The Text element lets users enter single-line text.

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

TIP

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

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.

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 Name", while the Unique Name could be user_name.

Description

Explanatory text displayed beneath the field, providing help information so 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 name")
  • 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 effect and user experience.

Validators

Validators check user input against a set of rules. Click a button to add a validator. Shows "No active validators" when none are added.

ValidatorDescription
RequiredMarks the field as required, ensuring it has been filled in
URLChecks whether the value is a valid URL
EmailChecks whether the value is a valid email address
NumberChecks whether the value is a valid number
IntegerChecks whether the value is an integer
Numbers and SpacesAllows only numbers and spaces
Letters and spaceAllows only letters and spaces
letters and numbersAllows only letters and numbers, no spaces
Less ThanChecks whether the value is less than or equal to the specified number
More thanChecks whether the value is greater than or equal to the specified number
Minimum lengthThe minimum character length
Maximum lengthThe maximum character length
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 "Preferred contact time" field when the user selects "Yes" for "Do you need a callback":

  • Match mode: Match any condition
  • Field: Do you need a callback
  • Operator: is
  • Value: Yes

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 source in Parameter name, and the user visits the form at:

https://yoursite.com/contact?source=google

the field is automatically filled with the value google. If the URL has no source 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 bring in known user information when jumping from other pages
  • A/B testing: Display different default values based on different 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 unique ID of the element, auto-generated by the system, read-only and not editable.

Filters

Filters pre-process input before the user submits. Click a button to add a filter.

FilterDescription
AlphaRemoves all non-letter characters
AlphanumericRemoves all non-letter and non-digit characters
DigitsRemoves all non-digit characters
RegexFilters using a custom regular expression
Strip TagsRemoves all HTML tags
TrimRemoves leading and trailing spaces from the value

Next steps

Built with VitePress