Adding questions to an onboarding form
Add pages and fields to a Create Form onboarding form, set what each question collects and make fields conditional or repeatable.
Add pages and fields to a Create Form onboarding form, set what each question collects and make fields conditional or repeatable.
This article is for System Admin and HR users. You need an onboarding form that already exists on the Forms tab under Settings > Onboarding, with its Source set to Create Form. Link and Upload forms have no questions to build.
Pages and fields
Forms are made of pages, and pages are made of fields. New forms start with a page called Page 1. Use Add page for more, rename a page from its tab, or remove one (this deletes the fields on it, after a confirmation). A form can have up to 20 pages and 500 fields. Page names are limited to 255 characters and must be different from each other.
Select Add Field on a page to add a question. Each field row has a label, a type, a Required switch, a delete button and a handle for dragging it to a new position. Open the arrow on the row to reach the detail settings.
Field types
- Text, a single line, and Paragraph, a longer answer.
- Email, Phone, URL and Date.
- Dropdown, where the starter picks one option. Add options with Add option. You need at least one, each must have a label, and labels must be unique. A dropdown can hold up to 300 options, each up to 255 characters.
- Checkbox, a single tick box. If it is required, the starter must tick it.
- Content block, text shown to the starter with nothing to answer. Type the text under Display text (up to 10,000 characters). Use it for instructions or a declaration to read.
- Image, a picture shown to the starter with nothing to answer. Choose it with Upload image (PNG, JPG, WebP or GIF, up to 2MB).
- Signature, a box where the starter draws their signature.
Number, File upload, Multi-select and Heading appear in the type list but are greyed out. They cannot be chosen on onboarding forms, so a Create Form form cannot collect files from the starter. To collect a completed file, use the Upload source instead.
Field settings
A field label is required and can be up to 2,000 characters. Repeating a label gives a warning but does not stop you saving. Help text (up to 1,000 characters) appears under the question. Required means the starter cannot move on or submit without answering. Content blocks and images are never required.
Answer length is available on Text and Paragraph fields. Set a minimum or maximum number of characters, words, or both. Use whole numbers of 1 or more, with each maximum no lower than its minimum.
Showing or requiring a field conditionally
Open a field's details and tick Show this field conditionally to display it only when an earlier answer matches your rule. Tick Require this field conditionally to make it required only in that case.
Each rule picks an earlier field, an operator (equals, does not equal, contains, does not contain, is empty, is not empty) and a value. Add more rules with Add condition and choose whether all or any must match. Only fields above the current one can be used as triggers, so drag the field lower down if the options are unavailable.
A field cannot be both plainly required and conditionally required: turn Required off before adding a required condition. When a field is hidden, anything the starter had typed into it is cleared and it does not block submission.
Repeatable sections
Use a repeatable section when the starter needs to give the same set of answers more than once, for example several emergency contacts. On each field that belongs in the section, tick Allow multiple entries (repeatable section) and enter the same name under Group label (up to 255 characters). Fields sharing a name become one section. The name is required, and the form cannot be saved without it.
Under the section you can set Minimum entries and Maximum entries (whole numbers of 1 or more, maximum no lower than minimum). Setting them on one field applies them to the whole section. Without a maximum, a starter can add up to 20 entries. If a minimum is set, the starter sees "Add at least N entries" until they have filled in enough.
Content blocks and images cannot be repeatable, and a Signature field needs to stay outside a section because it is not shown inside one. Conditions on fields inside a section can only refer to fields outside it. Answers in repeatable sections are not kept when a starter selects Save progress, so they need to be finished in one visit.
Saving and errors
The Save button stays unavailable while the form name is empty or a field has a blocking problem, such as an empty label or a dropdown with no options. Fields with problems are opened for you so you can fix them.
Once the form is saved, choose it as a task in an onboarding template. See "Building onboarding forms" for how, and "Reviewing onboarding forms and downloading PDFs" for what you see once a starter has submitted.