Starting onboarding for a hired candidate
How an Admin or HR user starts a new starter's onboarding by hand from the candidate's profile, and what happens next.
How an Admin or HR user starts a new starter's onboarding by hand from the candidate's profile, and what happens next.
Onboarding can be started by hand from the candidate's profile, or automatically when the candidate accepts their offer. This article covers starting by hand. The automatic route is covered in "Starting onboarding automatically when an offer is accepted".
Before you start
- Only Admin and HR users can start onboarding. Members see the Onboarding tab in view-only mode, with the message “You have view-only access. Only HR/admin can start onboarding or update task states.”
- Onboarding must be switched on for your organisation. If it is off, the Onboarding tab and the Onboarding page in the main menu are hidden. An Admin can change this under Settings, then Onboarding (the Enable onboarding switch).
- You need an onboarding template. Templates are created under Settings, then Onboarding templates. See "Setting up onboarding templates".
- The candidate must have an active application at a stage of type Offer or Hired (or a stage named Hired).
- The candidate needs an email address on their profile, because that is where the welcome email goes.
Start onboarding manually
- Open the candidate's profile and select the Onboarding tab. The heading reads “Onboarding has not been started for this application.”
- If the job the candidate applied for has no onboarding template, choose one from the Onboarding template list. If the job already has a template, this list does not appear and the job's template is used. If your organisation has no templates at all, the tab says “No onboarding templates are available. Create one in Settings first.”
- Optionally, fill in Reporting Manager (optional). It is only used by Email Trigger tasks whose Send to option is Reporting manager, and that email goes out only if the box holds an email address. If you type a name such as John Smith, the email is skipped. Enter an email address if your template has an email like this.
- Select Start Onboarding. The button stays greyed out until a template is available.
Onboarding is kept for each application. If the candidate has applied for more than one job, choose the application you want on the profile first. The Onboarding tab follows the selected application, and onboarding is started and followed for that application only. If the selected application is still a draft, the tab says “Onboarding can start once this application has been submitted.” If it is no longer active, it says “Onboarding can only start on an active application.”
If the candidate is not at an eligible stage, the tab shows “Candidate must be at the offer or hired stage to start onboarding.” The Start Onboarding button is still visible, but selecting it fails with an error saying the candidate must be at offer or hired stage. Move the application to the Offer or Hired stage and try again. If the candidate has no active application, the start fails with “No active application found for this candidate”.
The tab then switches to the progress view for that candidate. See "Tracking onboarding progress" for how to follow it.
Which template is used
The job's template always wins when the job has one. To use a different template for one candidate, change the template on the job's Onboarding tab first. When the job has no template, the template you pick on the candidate's tab is used.
The candidate's onboarding is built from a copy of the template taken at the moment you start. Editing the template afterwards does not change onboardings that are already running.
Starting again after cancelling
To apply a corrected template to a candidate, an Admin or HR user cancels their onboarding and then starts a new one. Cancelling cannot be undone, and the cancelled onboarding cannot be reopened. It stays on the Onboarding tab as a record, and a Start a new onboarding card appears above it. Choose the template (or, where the job has one, it is used), add a reporting manager if you need one and select Start Onboarding. The new onboarding is for the same application.
A completed onboarding cannot be started again. If you try, the start is refused with “Onboarding has already been completed for this application.”
What happens when onboarding starts
- The candidate receives the Onboarding Welcome email with their personal onboarding link. They do not need an account to use it.
- The hiring manager on the job receives an internal notification that onboarding has started.
- Tasks with no prerequisite become available straight away. Tasks that depend on another task start as Locked, showing “Waiting on prerequisite”, and open up when the earlier task is finished.
- Email Trigger tasks with no due offset that are available immediately are sent at once. Email Trigger tasks with a due offset wait for their due date.
- Due dates are worked out from the start date on the candidate's accepted offer plus each task's due offset. If the candidate has no accepted offer yet, tasks with an offset show Waiting for start date until there is one.
- An activity entry, “Started onboarding”, is recorded with the name of the person who started it.
Due dates are covered in "Setting due dates and prerequisites for onboarding tasks".
Problems you may hit
- “Onboarding has already been started for this application.” Only one active onboarding is allowed per application. Open the Onboarding tab to see it.
- “Onboarding has already been completed for this application.” A finished onboarding cannot be started again.
- Start Onboarding is greyed out: no template is selected yet, or your organisation has none.
- No Onboarding tab: onboarding is switched off for your organisation. Ask an Admin.
- The candidate did not get the welcome email: check the candidate has an email address. A template with no tasks completes immediately and sends no welcome email, so add tasks to the template before using it.
- Template changes are not showing for a candidate: the candidate's onboarding uses the copy taken at start. Cancel it and use Start a new onboarding to use the new version.