Skip to main content
Version: 1.28 (Current)

Forms 2.0 - Form Builder

caution

This page is preliminary and subject to change as Forms 2.0 continues to be developed.

The Form Builder is the design surface for a Forms 2.0 Form module. It's opened from the module's settings, and is organized around two tabs, Build and Settings (see the Settings page for the latter).

forms-2-0-form-builder.png

Across the top of the Form Builder:

  • The form name (editable inline) and the form ID (shown as #<id>), which is useful for referencing this specific form in tokens or scripts.
  • Back, to leave the Form Builder.
  • Save, to persist your changes.

Build tab​

The Build tab is where you add fields to the form and arrange them. It has two parts: a field palette on the left, and the Canvas on the right.

Field palette​

The left-hand panel lists every available field type as a clickable/draggable tile (for example Text Box, Dropdown, Date, Number, Phone, Rich Text Box, Button, and more). Adding a field to the Canvas adds an instance of that field type to your form.

A few field types are worth calling out because they're easy to mix up:

  • Layout Container - groups other fields together purely for layout (rows, columns, or a free-form grid). It has no value and doesn't change its fields' names. Use it to arrange fields side by side. See Layouting.
  • Section - groups related fields under a title into one JSON value, like the Customer section with First Name and Last Name in the example above. The fields inside are addressed by their full name, such as [Customer:FirstName]. See Section.
  • Dynamic Container - arranges fields like a Layout Container, but you can't drag fields into it. Its fields are added when the form loads, by the Dynamic Fields actions in On Preinit - see Dynamic Forms.
  • Repeater - lets the person filling out the form add and remove repeating groups of fields themselves (for example, to enter multiple addresses).

Canvas toolbar​

Above the Canvas:

  • A language selector (for example en-US), used to preview the form's text in any of the site's languages. It only appears when the form can be translated, so it isn't in the example above. A warning icon next to it flags that the currently selected language has fields with missing translations - see Localization on the Overview page.
  • Import and Export, to load or save the form's field configuration as a file.
  • The Narrow, Medium, and Wide buttons and the Width box, to preview the form at different widths - see Canvas width for details.
  • Add step, at the top right of the Canvas, to split the form into steps - see Multi-Step Forms.

Last updated: November 18, 2026