Multi-Step Forms
Forms can display all fields on a single page or as a multi-step wizard. In wizard mode, each section becomes a step that the respondent navigates through sequentially.
Display Modes
The display mode is configured in the form's experience settings.
| Mode | Behavior |
|---|---|
| Simple | All sections rendered on one page (default) |
| Wizard | Step-by-step navigation, one section visible at a time |
Wizard Options
When using wizard mode, these options control the navigation experience.
| Option | Default | Description |
|---|---|---|
allowStepNavigation | true | Let users click previous steps to navigate backwards |
showProgressBar | true | Display a progress indicator at the top of the form |
showStepNumbers | true | Show step numbers in the progress bar |
Button Labels
Button text is customizable per form. If not set, defaults from the language file are used.
| Button | Default | Description |
|---|---|---|
| Submit | "Submit" | Label on the final step's submit button |
| Next | "Next" | Label on the button to advance to the next step |
| Previous | "Previous" | Label on the button to go back one step |
Section Types in Wizard
Each section in the wizard renders according to the configured section type. The section type is set globally in config/filaforms.php under forms.section_type.
| Type | Rendering |
|---|---|
section | Card with heading and optional description |
fieldset | HTML <fieldset> with <legend> |
headless | No visual wrapper, fields render directly in the step |
Validation per Step
Each wizard step validates its own fields before the respondent can proceed. If the current step has validation errors, the "Next" button will not advance the form. The respondent must correct all errors on the current step first.
How to Set Up
Create a Form with Multiple Sections
In the form builder, organize your fields into separate sections. Each section will become one wizard step.
Set Display Mode to Wizard
Navigate to the form's Experience tab. Under "Display & Interaction", set the Display Mode to "Wizard".
Configure Wizard Options
Adjust the progress bar, step navigation, and step number settings to match your desired experience.
Customize Button Labels
Optionally set custom text for the Submit, Next, and Previous buttons. Leave blank to use the defaults.
Preview
Each section appears as a numbered step in the wizard. The respondent completes one step at a time, with validation enforced before advancing.