Step Section
A wizard step container with a heading, optional subtitle, and nested fields.
Overview
A step_section groups fields into one step of a multi-step form. Respondents see one step at a time with Previous / Next navigation and a progress indicator. Do not set required, instruction, reporting, or integration keys on the step container—configure those on nested answer fields instead.
The step heading uses label; optional copy under it uses stepDescription. See Multi-Step Forms.
Properties
| Property | Type | Default | Description |
|---|---|---|---|
| id | string | — | Unique field identifier (UUID in the builder). |
| type | string | step_section | Must be "step_section". |
| label | string | — | Human-readable label shown above the field or step heading. |
| stepNumber | number | 1 | Display order of this step (1-based). |
| stepDescription | string | undefined | Subtitle shown under the step heading. |
| isExpanded | boolean | true | Whether this step is expanded in the builder. |
| isHidden | boolean | false | Hide this step's content on the submission view. |
| fields | FormField[] | [] | Nested fields belonging to this step. |
JSON Schema
{
"id": "step_personal",
"type": "step_section",
"label": "Personal Information",
"stepNumber": 1,
"stepDescription": "Tell us a bit about yourself",
"isExpanded": true,
"fields": []
}Common Use Cases
- Long intake flows split into Contact → Details → Payment → Review
- Multi-phase registration separating eligibility checks from sensitive data
- Wizard-style configurators guiding users through dependent sections slowly
- Mobile-first surveys reducing scroll fatigue by one topic per screen
- Audit trails where each step maps to an internal workflow stage