Skip to main content
Documentation/Forms/Building Forms/Form Fields

Form Fields

Select Form Builder. From the Content tab, open Form > Fields. Use Add Field to add an input and drag field rows to reorder them. Type determines the input and its available options; Label names it for visitors.

Form field expanded with Type Label and Advanced
Form field expanded with Type Label and Advanced

Each field’s Advanced panel contains the applicable shared settings, such as required status, width, and conditional visibility. Field-specific options are described below.

Text Fields

Text

Collects a single line of text. Use it for names, company names, or other short answers.

  • Advanced > Mask — Formats input to a pattern, such as a fixed-length reference number. See Input Masks.

Email

Collects an email address, with browser checking for email format. Use it for contact details or email subscriptions.

Use the shared settings to configure its default value, placeholder, and required status.

Textarea

Collects multiple lines of text. Use it for messages, questions, or longer descriptions.

  • Rows — Sets the visible height in lines of text.

URL

Collects a complete web address, such as https://example.com. Use it when visitors need to provide a website or page link.

Use the shared settings to configure its default value, placeholder, and required status.

Phone Number

Collects a telephone number. Use it for callback details; accepted formatting can include country codes, spaces, and punctuation.

Use the shared settings to configure its default value, placeholder, and required status.

Password

Masks the characters visitors enter. Use it when collecting a password as part of a custom form workflow.

Use the shared settings to configure its default value, placeholder, and required status.

Choice Fields

Radio

Displays a set of options from which visitors choose one. Use it for a short list of mutually exclusive answers.

  • Options — Defines the available choices.
  • Option Label — Text shown to visitors.
  • Option Value — Value sent in the submission. If unset, the label is used. Set an explicit value to keep integrations stable when labels change.
  • Selected — Makes one option selected when the form first loads.

Checkbox

Displays options that visitors can select independently. Use it for interests, requested services, or a single consent checkbox.

  • Options — Defines the available choices.
  • Option Label — Text shown to visitors.
  • Option Value — Value sent in the submission. If unset, the label is used. Set an explicit value to keep integrations stable when labels change.
  • Selected — Makes the option checked when the form first loads. Enable it for each default selection.

Select

Presents choices in a dropdown or a list that supports multiple selections. Use it to keep a longer list of options compact.

  • Options — Defines the available choices.
  • Option Label — Text shown to visitors.
  • Option Value — Value sent in the submission. If unset, the label is used. Set an explicit value to keep integrations stable when labels change.
  • Selected — Makes the option selected when the form first loads. Set one default for a single-choice dropdown or several when Multiple is enabled.
  • Multiple — Allows visitors to select more than one option.
  • Rows — Sets the number of visible options when Multiple is enabled.
  • Advanced > Placeholder — Sets the initial empty option in a single-choice dropdown. The default text is “Select…”.

Numbers, Dates, and Times

Number

Collects a numeric answer. Use it for quantities or other values that need a range or fixed increment.

  • Min — Sets the lowest allowed value.
  • Max — Sets the highest allowed value.
  • Step — Sets the allowed increment, such as 1 for whole numbers or 0.5 for half-unit increments.
  • Advanced > Value — Sets the initial numeric value; see shared settings for dynamic defaults.

Date

Collects a calendar date. Use it for a preferred appointment date or another date-based answer; the picker’s appearance depends on the visitor’s browser.

  • Min Date — Sets the earliest allowed date in yyyy-mm-dd format.
  • Max Date — Sets the latest allowed date in yyyy-mm-dd format.
  • Advanced > Value — Sets the initial date; see shared settings for dynamic defaults.

Time

Collects a time of day. Use it for a preferred contact or appointment time; the picker’s appearance depends on the visitor’s browser.

  • Advanced > Value — Sets the initial time; see shared settings for dynamic defaults.

Other Fields

File Upload

Accepts files from visitors. Use it for documents, images, or other attachments.

  • Max. File Size (MB) — Limits the size of each file. The default is 10 MB; WordPress or server limits may be lower.
  • Max. Number of Files — Limits how many files visitors can attach. The default is one; a higher value allows multiple files.
  • Allowed File Types — Restricts accepted formats. Available choices come from the site’s WordPress MIME settings.
  • Drag and Drop — Adds a drop area alongside the option to choose files.

See File Uploads for retaining files, emailing attachments, and adding allowed file types.

Hidden

Includes a value in the submission without displaying an input. Use it for a campaign identifier or a value supplied through Dynamic Data.

  • Advanced > Value — Sets the submitted value. See Dynamic Field Values to populate it from page, URL, or other supported data.

HTML

Displays custom HTML within the form. Use it for instructions, links, or formatted content between inputs.

  • HTML — Contains the markup rendered at this position in the form.

Step

Starts a new screen in a multistep form. Place a Step before the first group of inputs and before each subsequent group.

  • Label — Names the step in the progress indicator.
  • Previous Button Text — Sets the label for returning to the previous step.
  • Next Button Text — Sets the label for advancing to the next step. Next validates the current step’s fields.
  • Icon — Replaces the step number in the progress indicator.

Each step contains the inputs that follow it, up to the next Step. The final button uses Form > Submit Text, and submission actions run after the final submission. See Multistep Forms for setup and styling.

Advanced Settings

These shared settings appear in each field’s Advanced panel where applicable.

  • ID — Unique field identifier used by action mappings and variables such as {email}. Update references when changing it. Available on input fields.
  • Value — Initial value for text-based, Number, Date, Time, and Hidden fields. Supports Dynamic Field Values on compatible controls. Choice fields use Selected under Options for defaults.
  • Placeholder — Hint shown in an empty Text, Email, Textarea, URL, Phone Number, Number, or Password input. Select uses it for the initial empty option described above.
  • Required — Requires an answer before submission. Available on visitor input fields.
  • Width — Field width from 1–12 columns: 12 fills a row, and 6 fills half. Consecutive half-width fields share a row.
  • Conditional — Enables a visibility rule. Condition chooses the controlling field, comparison, and value. See Conditional Form Fields for comparisons and how hidden fields affect validation and submission.
  • Hide Label — Visually hides the label. Retain meaningful label text for assistive technology.
  • Autocomplete — Browser autofill hint, such as name, email, or tel. Available on Text, Email, Textarea, URL, Phone Number, Select, Number, Date, Time, File Upload, and Password fields.