Use Section to group related questions under an optional heading and description. It owns a child grid, so you can move the whole group together or conditionally include its public questions. Section is available in Free.
Availability: Core (Free).
Add and configure the field
- Open the form in Build and add Section from Add fields.
- Select its canvas card to open Field options, then configure the controls below.
- Save the form and check its saved Preview and embedded page.
Field-specific settings
| Setting | What it does |
|---|---|
| Heading | Optional Heading, displayed above the child fields. |
| Description | Plain-text Description supporting the heading. |
| Show divider | Show divider starts enabled. Turn it off when the grouping needs no horizontal rule. |
| Required message | A shared message control retained by this provider; Section itself collects no answer and has no Required check. Set a child's required message on that child. |
| Invalid value message | Section has no submitted answer to validate. Child validation still uses each child's own controls. |
Applicable shared options
This field also provides CSS classes. See common field options for their behavior.
Answers and behavior
Drag fields into its drop area and arrange or resize them within the child grid. The Section occupies a complete main row; its children use the ordinary grid. One level is supported: Sections cannot nest, and a Repeater cannot be placed inside a Section.
Drag the Section handle to move the whole group. Children can move into, out of or between Sections. Duplicating the Section duplicates its children with new field IDs and remaps conditions between copied fields; references to fields outside the group still point outside it. Review the copy before saving.
A Section condition combines with each public child's own condition. A child appears only when both permit it. A Section cannot depend on its own descendant. Section stores no answer; children keep independent entry values and merge tags.
Deleting a Section also deletes its children. Move any questions you want to keep outside the group first. Undo can restore the unsaved group. A successful form Save applies confirmed field deletion to saved values.
Example and checks
Create a Shipping details Section and move Address and a delivery-instructions Paragraph into it. Add a request-type rule to the Section if shipping is optional. Test the group becoming inapplicable, required-child validation and a return to the matching request type.
Use Section for grouping without repetition. Use Repeater for a visitor-controlled collection of people or line items. Section is not an accordion and does not create a separate entry.
Use the testing checklist to check validation and the saved entry. Explore all fields provides live examples.
