Skip to content

Multi-step forms ​

Break long forms into multiple steps with Next/Previous navigation, a progress indicator, and per-step validation. Useful for surveys, applications, and quote forms where presenting everything at once feels overwhelming.

Add a step break ​

  1. Open the form in the builder.
  2. From the field library, drag a Step break item into the canvas at the position where you want the next step to begin.
  3. Optionally set a custom Next and Previous label on the step break (defaults to "Next" / "Previous").
  4. Repeat for as many steps as you need.

Fields above the first step break form step 1; fields between two step breaks form the next step; fields after the last step break form the final step.

Frontend behaviour ​

  • Visitors see one step at a time.
  • A progress indicator shows the current step and total steps.
  • The Next button validates the current step before advancing — if any required field on the current step is empty or invalid, the visitor stays on the same step and sees the error inline.
  • The Previous button moves back without re-validating.
  • The form's submit button only appears (and only fires) on the last step.

Validation across steps ​

Server-side validation runs once on final submission. The per-step validation on Next is a UX improvement — the source of truth is still the server, which validates the full payload regardless of how steps were navigated.

Hidden fields and steps ​

Fields hidden by conditional visibility rules are skipped during per-step validation as well as on submission.