Repeatable sections: employment history, education and references
How to build application form sections that candidates repeat for each job, qualification or referee, and what candidates see when they fill them in.
How to build application form sections that candidates repeat for each job, qualification or referee, and what candidates see when they fill them in.
A repeatable section is a group of questions that a candidate answers more than once: one set for each job they have held, each qualification they have gained or each referee they name. This article covers building the section and what candidates see. Saving the answers to the candidate profile and employment gap checks have their own articles, listed at the end.
Who can do this
System Admin and HR users can build and change repeatable sections. You can do it in a template (Settings, then Application Form Templates, under the Templates group) or on the Application Form step of a job. Members and hiring managers cannot edit application forms.
How a section is built
There is no separate "repeatable" question type. You tick Repeatable on a question and place it in a section. Every question in the same section is repeated together, and each one is a sub-field of that section. Sub-fields can be Text, Paragraph, Email, Phone, URL, Date, Dropdown, Multi-select, Checkbox or Signature questions. Headings and content blocks do not collect answers, so they do not belong in a section.
Each section has a purpose, which decides where its answers can be saved:
- Employment history: answers can be saved to Work History on the candidate profile, and the dates take part in gap checks.
- Education history: answers can be saved to Education on the profile. Study dates also take part in gap checks and fill gaps between jobs.
- References: answers create referee records on the profile.
- Custom (answers only): the default. Answers stay with the application and nothing is copied to the profile.
Adding a section
The quickest route is a ready-made section. Open the form, select Add pre-built and choose References, Employment history or Education history. The section arrives with its purpose set and every question already connected to the matching place on the profile. Once a section has been added, its entry shows Added in the menu and cannot be chosen again.
Some questions in these sections, such as Employer and Referee email, cannot be deleted one at a time. To remove the whole section, select the bin icon beside the Group: label above it and confirm with Remove section. This deletes every question in it, including the locked ones.
To build your own section:
- Add a question with Add Field and open its details.
- Tick Repeatable.
- Under Repeatable section, choose New section… and type a name in Group label. Candidates see this name as the heading of the section.
- Choose a Section purpose. Leave it as Custom (answers only) if the answers do not need to reach the profile.
- Add each further sub-field as its own question, tick Repeatable, and pick the same section from the Repeatable section list. Choosing an existing section also picks up its purpose.
- Select Save.
Renaming the group label later does not split the section. The questions stay together. If you pick New section… for a question that should have joined an existing section, it becomes a second section with its own Add another entry button, so check the list before you choose.
A job's application form can hold up to 200 input questions, and every sub-field counts towards that total.
To show a whole section only when an earlier answer matches, select the cog beside the Group: heading and set Only show this section if in the box that opens. The rule is written onto every question in the section, so required questions such as Employer no longer stop you hiding it. How conditions work is covered in How conditional logic works on application forms.
Minimum and maximum entries
When a question is repeatable, Minimum entries and Maximum entries appear. Both are optional. Enter whole numbers of 1 or more, with the maximum no lower than the minimum, otherwise the form shows "Enter whole numbers of 1 or more, with the maximum no less than the minimum." The limits apply to the whole section, whichever question you set them on.
With no minimum, candidates start with one entry and cannot remove the last one. With a minimum of 3, they start with three blank entries and cannot remove any below that. With a maximum, the add button switches off once the limit is reached.
What candidates see
The section appears under its group label. Each entry is a numbered box (Entry 1, Entry 2) holding the sub-fields. Candidates can:
- select Add another entry to add a new set of questions;
- use Move up and Move down to reorder entries;
- use Remove this entry to delete one, unless they are at the minimum.
At the maximum, the button is disabled and the text "Maximum of N entries reached." appears. If a candidate tries to move on with too few entries, they see "Add at least N entries to "Section name" before continuing." The same limits are checked again when the application is submitted.
Required sub-fields must be answered in every entry, so an entry cannot be left half empty. Entries where all sub-fields are optional can be left blank. Show when rules on individual questions work entry by entry, so a question can appear in one entry and stay hidden in another.
On a Start date or End date question connected to Employment history or Education history, candidates can tick I don't know the exact day and give only a month and year. Where a missing day could be hiding a gap, the form shows a card headed "Possible gap, exact dates unknown" with an optional note. This card never stops the candidate submitting.
An entry whose end date is before its start date cannot be submitted. The candidate sees "The end date is before the start date. Please check the dates." This applies on the careers form and when a candidate resumes, reopens or edits an application. A form saved to finish later still saves. An entry marked as the current role is never flagged, and month and year dates are compared by month.