Repeating Pages

Most of the forms you design will take a user through a series of pages, completing each one until they get to the end, perhaps skipping over optional pages depending on how the form is filled out.

Repeating pages are pages of your form that can be completed more than once. That means a user can complete the same page multiple times, building up a collection of data that's submitted with the form.

Repeating pages can also make your form designs simpler. You can dynamically set the number of repeats, which means you don't have to rely on showing and hiding fields, or on complex conditional logic.

Once a page has been flagged as repeatable in the Page Settings, the Wizard Buttons - Repeating Pages field can be used to add and remove instances of the page. By default the field has buttons that let a user add another, update and remove a page instance, as well as providing buttons when editing an instance.

You can display the data submitted with each instance of a page using the HTML Template (server-side) field. We recommend using the card view.

This documentation introduces repeating pages, describes the core functionality, and links to relevant documentation around the site.

Definitions

Page - A page of your form, whether published on your site or while you are working in the forms designer.

Repeatable - A page setting. Making a page repeatable means it can be filled out multiple times.

Instance - A particular repeat of a page. By default a page has a maximum of one instance - a user fills it out once before moving on to the next page. A repeating page can have multiple instances. In the forms designer you can also set the minimum and maximum instances, ie the minimum and maximum number of times the page should repeat.

Generated vs Completed Instances

Just because a page repeats doesn't mean it will contain any data. If all of the fields on a repeating page are optional, a user can submit empty versions of it (and generate further instances). These empty instances still count towards the minimum and maximum instance counts you have set in your form design. For that reason this documentation refers to generated instances, rather than completed instances.