Onboarding Wizard
Use the Onboarding Wizard to set the checklist every new employee completes when they join: reviewing their role, pay and schedule, confirming bank details, government IDs and emergency contact, uploading an ID and signing your policies. You can also send a welcome email. Each completion is timestamped and kept on record.
Where: My Team › Settings › Onboarding & Offboarding › Onboarding Wizard
You need: the Onboarding Wizard right. Employees need nothing to complete their own checklist.
Which one, when
| You want | Use |
|---|---|
| New joiners to work through a checklist themselves | Onboarding Wizard |
| To add an employee to KAMI | Adding and onboarding employees |
| To collect acknowledgement of a policy from current staff | Policy Center |
| Settings applied automatically by placement | Profile Automations |
| To chase missing details later | Missing Data report |
The Add Employee wizard is what you fill in to create someone. The Onboarding Wizard is what they complete afterwards.
How it works
Every company has a General wizard. It applies to everyone whose position is not on another active wizard. It can be switched off but not deleted. For a role with a different flow, create a wizard for those positions. A position can belong to only one wizard, and positions you remove from a wizard fall back to General.
Onboarding starts at two moments only: when an employee is added, and when they move into a position that has its own wizard. Saving or changing a wizard never starts it for current staff.
How to set up the checklist
- Open My Team › Settings and select Onboarding Wizard.
- Select the wizard, such as General.
- Under Checklist steps, select a step to preview what employees see, and use its switch to turn it on or off. The switch saves straight away. Welcome, Employment details, KAMI User Guide and Finish onboarding are always included.
- To use Policies & code of conduct, select it, enter the Policy content and Confirmation text, and select Save policy. Then select Attach document to add files if you want.
- To add your own step, select the plus icon beside a section, enter a Title and Description, choose Visible to positions (empty means all), and select Add step.
- To set a deadline or the email, select the pencil icon (Edit wizard details), set Days to complete onboarding and Welcome email, then select Save changes.
The available steps are Your wage, Attendance policy, Meet your team, Bank & payout details, Government IDs, Upload a valid ID, Emergency contact, Policies & code of conduct and Orientation training. Government IDs lists your custom fields in the ID & Registrations section. Orientation training needs the LMS module.
How to create a wizard for certain positions
- On the Onboarding Wizards page, select Create new wizard.
- Enter a Name and Description.
- Under Assign to positions, choose at least one. Positions used by another wizard are greyed out.
- Set Days to complete onboarding if you want a deadline, counted from the hire date.
- To send an email, select Configure welcome email.
- Select Create wizard, then set up its checklist as above.
To stop using a wizard, turn off its switch. To remove one you created, open it and select the bin icon. With General switched off, a new hire in a position with no wizard gets no onboarding.
How to set up the welcome email
- Open the wizard's details, then select Configure welcome email, or Welcome email when editing.
- Enter the Subject and Message. Both are required while the email is on.
- To personalise it, click a variable to insert it where you were typing: Company name, First name, Last name, Full name, Position, Hire date, Manager name or Manager email.
- Add CC or BCC addresses if you want, up to five each. The employee is always the recipient.
- Select Save. It is saved together with the wizard. To stop sending it, select Remove email.
How employees complete onboarding
- A Complete your onboarding bar sits at the bottom of every page. Select Continue.
- Work through each step in the list. Review steps need a confirmation. Records steps let them confirm the details or select Request a change.
- On Policies & code of conduct, type your full name, tick the box and select Agree & sign.
- When every other step is done, select Finish onboarding.
The bar cannot be dismissed, but it does not stop anyone using KAMI. Change requests and uploaded IDs go to HR for approval and show Awaiting approval. Upload a valid ID only appears if the employee has no valid ID on file.
How to check or restart someone's onboarding
- Open the employee's profile and go to the Employment tab.
- Find the Onboarding card. It shows Onboarding in progress or Onboarding completed with the date.
- To make them do it again after finishing, select Relaunch onboarding.
What Happens Next
- The welcome email goes to the employee's KAMI login email when the wizard is assigned, if they have already been invited. If they have not been invited yet, it waits and goes out when you invite them. Resending an invitation does not send it again, and nobody gets it twice for the same wizard.
- They must be invited and activated to log in and see the checklist. See Invites & Activation.
- Requested changes update the profile only once approved. If HR declines one, the step reopens so the employee can resubmit.
- Changes to a wizard reach people still in progress. Someone who has finished is not affected.
Tips
- Set this up before your first big intake. Onboarding does not start for people already added.
- Turn on only what you will use. Every step is required, so each one adds work on someone's first day.
- Write the welcome email to work on any day. It can arrive on hire or on invite, so "Welcome to {company name}" reads better than "Today is your first day".
- Test it with a new test employee, because the checklist looks different from the employee's side.
- Run a Missing Data check a week later, while the person is still new enough to ask.
Troubleshooting / FAQ
Q: A new employee never saw the onboarding checklist. Check they were invited and have activated their account. Then check the Onboarding card on their profile. If it says no wizard is assigned, General or their position's wizard was off when they were added.
Q: A new employee never got the welcome email. They have not been invited yet, the wizard has no welcome email, or they are deactivated.
Q: How do I make current employees do onboarding? It does not start for current staff. Use the Policy Center to have them acknowledge a policy. You can restart it for someone who finished with Relaunch onboarding.
Q: Details an employee entered are not on their profile. The change is waiting for approval. Check their step shows Awaiting approval, and approve the request.
Q: Can I change the order of the steps? The built-in steps have a fixed order. You can drag your own custom steps between sections.
Q: An employee cannot select Finish onboarding. It unlocks when every other step is done. The step lists what is left.