The Text element is a form element that lets the user enter a single line of text.
Sets the label of the element.
Sets description text to display below or above the field.
Sets the field to be required, i.e. the user must complete this field.
Choose an icon to display in the label.
Choose icons to display on the left or right side of the field.
Sets the vertical height (using padding) and font size of the field.
Sets the width of the field, choose one of the preset sizes or choose a custom width.
Field custom width
If Field width is set to Custom enter a custom width using any CSS value.
Custom CSS class
Add a custom CSS class to the field, or multiple classes separated by a space.
Add custom CSS styles to any part of this element by clicking Add a style, choose the selector that the style should apply to and enter the CSS into the box.
Sets the placeholder text, which is text inside the field that is visible before the user enters a value.
Sets a small text label below the field.
Sets the admin label which allows you to have different label text for the element when viewing entries and within notification emails than the label text shown in the form.
Sets the tooltip text which is shown in a small popup when the user interacts with the tooltip trigger.
Choose what the user will be interacting with to show the tooltip, the choices are Field, Icon, or Inherit which will inherit the setting from the parent Group, Page or Form setting.
Choose the event that will trigger the tooltip to show, the choices are Hover, Click, or Inherit which will inherit the setting from the parent Group, Page or Form setting.
Choose where to display the label relative to the field, the choices are Above, Left, Inside, or Inherit which will inherit the setting from the parent Group, Page or Form setting.
If the Label position is set to Left enter a custom label width using any CSS value.
Enable conditional logic
Enable or disable the conditional logic for this element.
Add a logic rule to this element by clicking Add logic rule, then choose the element, operator and value that will trigger the rule.
Sets the default value of the element, which is the value that the field has when the form is first displayed. You can insert a variable by clicking the code icon at the side of the field.
Dynamic default value
Enable or disable the dynamic default value for this element. This option allows the field value to be set from a URL parameter, block value, shortcode attribute or filter hook. See the Dynamic default value guide for more information.
Sets the name of the parameter to use as the source of the dynamic default value.
Sets the maximum allowed length of the submitted value, the user will not be able to enter more than this number of characters into the field and it is also validated on the server side. You can change the error message on the Translations tab.
Sets the field to be read only, meaning the user cannot change the value of the field. Note: you cannot rely on the value never being changed, as knowledgeable users will be able to change the value by other methods.
Show in email
If enabled, the submitted element data will be shown in the default notification email.
Save to database
If enabled, the submitted element data will be saved to the database and shown when viewing an entry.
The unique element identifier is displayed here, you may need this for advanced usage.
Sets the element to only be visible when viewing/editing entries (Admin only), or only visible to logged in or logged out users.
Add filters to the element which strip unwanted characters from the submitted data. Available filters for this element are listed below.
- Alpha – removes any non-alphabet characters
- Alphanumeric – removes any non-alphabet characters and non-digits
- Digits – removes any non-digits
- Strip Tags – remove any HTML tags
- Trim – removes white space from the start and end
- Regex – removes characters matching the given regular expression
Add validators to the element which checks whether the data entered by the user is valid and displays an error message if it’s not valid. Available validators for this element are listed below.
- Alpha – checks that the value only contains alphabet characters
- Alphanumeric – checks that the value only contains alphabet characters or digits
- Digits – checks that the value only contains digits
- Email – checks that the value is a valid email address
- Greater Than – checks that the value is numerically greater than the given minimum
- Identical – checks that the value is identical to the given token
- In Array – checks that the value is in a list of allowed values (can be inverted)
- Less Than – checks that the value is numerically less than the given maximum
- Length – checks that the length of the value is between the given minimum and maximum
- Prevent Duplicates – checks that the same value has not already been submitted
- Regex – checks that the value matches the given regular expression (can be inverted)
Depending on the current settings this tab may or may not be visible, you can translate the text of any relevant settings here.