Repeatable Sections: Building Repeatable Sections
Repeatable Sections allow users to enter a variable number of entries for the same set of questions—typically used for entering things like parts, labor, or material line items.
Entered line items are laid out in a summary table view, making it easy for mobile users to review their work.
Repeatable sections are easily configured in the Form Builder. This article will discuss how to add, edit, and delete Repeatable Sections and associated questions/features in the Version 2 Form Builder.
Review the video below for a demonstration of Repeatable Sections in the mobile app.
Review the video below for instructions on adding a Repeatable Section to a form.
Go to the place in your form where you would like to add a Repeatable Section; this can be after a Regular section A regular section is a section type available in the Form Builder that enables the form designer to arrange multiple types of questions under one heading. Unlike a repeatable section, a question in a regular section can only accept one response from the mobile app user. on an existing page or on a new page.
Select Add a Section.
Choose Repeatable as the section type.
Name the section, and optionally customize the unique identifier. Read more about general section properties here. Then, select save.
The Repeatable Section will be created. It will be easily identifiable by the table view.
Editing a Repeatable Section's Information
To edit a Repeatable Section's Information, simply select the menu icon next to the section name and select Edit. Here, you will be able to edit any options selected in the initial creation of the section.
Deleting a Repeatable Section
To delete a Repeatable Section, select the menu icon next to the section day and select Edit. At the bottom of the settings and options page, select Delete Section.
Copying a Repeatable Section
Copying a Repeatable Section can be done directly through the menu icon and selecting Copy Section. This will also copy any conditional logic contained within the Repeatable Section but will not copy any conditional logic referring to or originating from outside the section.
Repeatable sections appear as clean, easily read and managed sections on your mobile users' devices. This is an image from the Android client, demonstrating a filled-out Repeatable Section:
For more information on each of these parts, please read:
Find your Repeatable Section.
Press the Edit Summary Table or Questions button to launch into your Repeatable Section.
You will now be "inside" the Repeatable Section.
All sections and questions listed on the right panel are inside of the Repeatable Section.
How to identify that you are in a Repeatable Section
- The "breadcrumbs" in the title show the name of the main form, then the name of the Repeatable section A Repeatable Section is a type of section that contains sets of questions that the field user can answer multiple times, “repeating” the process as needed. For example, the field user can answer the same set of questions for each piece of equipment that they need to inspect. you are currently in.
- The form building tab says Repeatable Section Builder.
- The Return to Main Form button at the top of the left navigation menu.
- The nested left navigation menu (showing the sections inside of your Repeatable section).
- The Summary Table designer at the top of the right panel.
To exit the Repeatable Section, click on Return to Main Form, or click anywhere outside of the Repeatable Section in the left navigation.
Creating, editing, and managing questions inside of your Repeatable Section is done on the right panel. All the interactions are identical to adding these items into your main form, except for the following restrictions.
You can configure some question types to populate answers in other questions. This functionality has some restrictions in Repeatable Sections.
Questions inside of a Repeatable Section can only push answers into other questions inside of the same Repeatable Section (including Repeatable Sections nested within the current one).
Questions that are outside of the Repeatable Section, but come before it, can push information into questions that are in Repeatable Sections.
When you use the Router Setup property, the following limitations apply:
- A source question in a regular section can’t route data to questions in a Repeatable Section, except for questions in the footer.
- A source question in a Repeatable Section can only route data to target questions within the same Repeatable Section.
- A source question in a nested Repeatable Section can only route data to target questions within the same nested Repeatable Section.
- A question in the footer of a Repeatable Section can’t route data to any question in the form.
Referencing Other Questions
Many types of questions, like Calculations, String Concatenation, or filtering of dropdown questions, use references to previous answers in the form. There are some restrictions around this functionality and Repeatable Sections.
- A question in a Repeatable Section can reference back to:
- Previous questions in the same Repeatable section
- Previous footer questions in the same Repeatable section
- Questions one level up (i.e., in the main form) that come before the Repeatable section
How Many Questions can I have in a Repeatable Section?
There is no specific limit, but keep in mind that questions in a Repeatable Section are listed on a single form page. Too many questions on one page are difficult for a user in the field to handle. If you have excessive amounts of questions on ANY page in a form, you may begin to run into performance issues on a mobile device.
Moving Sections and Questions
Sections and questions that are inside of a Repeatable Section can only be rearranged within the Repeatable section; they cannot be moved outside of it.
Example of Nested Repeatable Sections
You can nest Repeatable Sections inside a main Repeatable Section. Nested Repeatable Sections can help you to keep collected information organized.
The following example shows the summary of a Campus Inspection form with two levels of nested Repeatable Sections.
The main Repeatable Section is Building Inspection. The inspector can add as many buildings as needed.
The first nested Repeatable Section is Floor inspection. The inspector can add as many floors in a building as needed.
The second nested Repeatable Section is Room inspection. The inspector can add as many rooms on a floor as needed.
Steps to Add a Nested Repeatable Section
From the Manage Forms menu, navigate to the form you want to configure.
Select EDIT FORM.
Result: The form opens in edit mode.
Do you have a Repeatable Section configured?
If yes, go to the next step.
If no, add the main Repeatable Section.
Select EDIT SUMMARY TABLE OR QUESTIONS.
Result: The Repeatable Section opens in edit mode.
Select ADD A SECTION, and then select Repeatable.
Result: The system adds a Repeatable Section nested inside the main section. You can add questions to the nested Repeatable Section, or add additional sections
Note:You can only add two levels of nested Repeatable Sections inside a main Repeatable Section.
Once you have created the sections and questions you want, here are the next steps you can take.