Reviewing, approving and finishing onboarding tasks
Approve or reset submitted forms, move tasks along on a new starter's behalf, and see what happens when the last task is done.
Approve or reset submitted forms, move tasks along on a new starter's behalf, and see what happens when the last task is done.
This is for Admin and HR users working from a candidate's Onboarding tab while onboarding is active. Onboarding must already have been started for the candidate. How the new starter completes their own tasks is covered in "What new starters see in the onboarding portal".
Tasks that need review
The Requires review switch is on Form tasks in the template. With it off, a submitted form is Done straight away and anything waiting on it unlocks. With it on, the task becomes Under review and the new starter sees “Your submission is being reviewed by the team.” The job's recruiters and hiring managers get an email saying the form was submitted, provided they have onboarding update notifications switched on.
An Admin or HR user then opens the candidate's Onboarding tab and either:
- selects Approve, which marks the task Complete, unlocks anything waiting on it and emails the new starter that their submission was approved, or
- selects Reset, which returns the task to Not Started and emails the new starter asking them to do it again. Their new submission replaces the earlier answers.
An onboarding cannot finish while a task is still Under review.
Moving tasks along as staff
Admin and HR users can update any unlocked task from the candidate's Onboarding tab. This is useful when a new starter completes something on paper. The buttons depend on the status.
| Status | Buttons |
|---|---|
| Not Started | Start, Complete, Skip |
| In Progress | Submit for Review, Complete, Skip, Reset |
| Pending Review | Approve, Skip, Reset |
| Complete or Skipped | Reset |
| Locked | None |
Complete on a Form task marks it done but records no answers. The exception is a task that collects an uploaded document: Complete and Submit for Review are refused until the new starter has uploaded the file (“The candidate must upload a document before this task can be completed or sent for review.”). A task that was already waiting for review before this rule applied can still be approved.
Reset on a Complete, Skipped or Pending Review task emails the new starter to say it needs doing again. Start and Skip send no email. Each unlocked task also has Email Candidate, which sends the new starter a message about that task.
If two people change the same task at once, the second sees “Task status changed concurrently. Please refresh and try again.” Reload and check its current status.
When every task is finished
An onboarding is complete when every task, including Internal and Email Trigger tasks, is Complete or Skipped. At that point:
- the onboarding's status becomes Completed and the tab shows the completion date
- the new starter is emailed to say they are all set
- the job's hiring managers are emailed that the onboarding is complete, if they have onboarding update notifications on
- the portal shows You're All Set! in place of the checklist
The task buttons disappear and a completed onboarding cannot be reopened. The new starter cannot submit anything further.
While onboarding is in progress the portal link has no expiry. Completion starts a 30 day clock, shown on the tab as “Portal expires [date]”. After that date the link shows Link Expired and asks the new starter to contact your HR team. Admin and HR users can change the date with Extend portal access, as described in "What new starters see in the onboarding portal".
Problems you may hit
- The onboarding will not complete: look for a task on the Onboarding tab that is still Not Started, In Progress, Pending Review or Locked, including Internal tasks.
- A new starter sees Onboarding Closed with the message “This onboarding is no longer active.” and no tasks: the onboarding was cancelled, including for a page they already had open. Start a new one if that was a mistake. See "Starting onboarding for a hired candidate".
- A task has no buttons: it is Locked. See "Setting due dates and prerequisites for onboarding tasks".