| ROLE | ACCESS LEVEL | REPORTS TO |
|---|---|---|
| All Roles | Reference + Rollout | Company Administrator |
| The complete reference for Xemplo Onboard - concepts, roles, procedures, status tracking, troubleshooting, and rollout, built to the Xemplo Best Practice User Guide Framework. |
Xemplo Onboard replaces manual, paper-based new-starter processes with a single self-service workflow: HR creates the onboarding, a Signing Manager reviews and releases it, the worker completes every step themselves, and HR performs one final review before the record is handed to Xemplo Employ. The outcome is a consistent, compliant onboarding experience delivered without admins chasing paperwork.
Where Onboard sits in the Xemplo lifecycle
Onboard is the first product in the Xemplo suite. A completed onboarding record becomes the foundation for everything that follows:
- Onboard - new-starter setup, compliance, contract signing
- Employ - ongoing employment records, leave, performance
- Pay - payroll processing
- Bill - timesheets, approvals, client billing
Why this matters: A worker record only moves cleanly into Employ if the Position, Compliance Rules and Contract were set up correctly in Onboard. Getting the foundation right here removes rework in every downstream product. |
Where Onboard sits in the Product Ecosystem
Per the Xemplo Product Ecosystem - High-Level Outline, Onboard is a Product Group within the Platform layer, made up of three Products:
| Product | Feature / Support Category |
|---|---|
| Pre-Onboarding | Pre-Onboarding |
| Hire | Jobs · Talent Pools · Automated Job Posting (Indeed, JORA, LinkedIn, Seek, Careers For Carers) |
| Onboarding | HR Onboarding · Worker Onboarding · New Worker Sync (Employment Hero, Xero, Talenox, Guardhouse, Shiftcare, VisualCare, Xemplo Connect) |
This guide focuses on the Onboarding product specifically - HR Onboarding and Worker Onboarding - which is what the Onboard role guides and this master guide are built around. Hire and Pre-Onboarding sit upstream and are covered only where they hand off directly into an onboarding record.
The eight core objects - where Onboarding fits
The Xemplo User Guide (Journey-Based) identifies eight objects that recur across the whole suite: Position, Engagement, Assignment, Contract, Worker, Contractor, Host, and Agency. Onboard works directly with three of these — Position, Contract, and Worker/Contractor. Engagement, Assignment, Host and Agency are set up primarily in Bill and read by Onboard rather than created there.
| Cross-reference This guide is the internal training counterpart to Journey C (“Hiring someone new”) and Journey D (“Onboarding a worker or contractor”) in the customer-facing, journey-based Xemplo User Guide. Content Briefs v3 flags Journey D as the single highest-priority section in that guide — the same emphasis this master guide gives Onboard. |
|---|
Who this guide is for
This guide covers all three roles involved in Xemplo Onboard: Super Administrator (platform foundation), Company Administrator (company configuration and oversight), and HR Manager (day-to-day onboarding operations). Role-specific extracts of this guide are also available — see Section 13, Resources and Support.
Core Concepts Glossary
Five concepts underpin everything in Onboard. Understanding how they connect — particularly that Position drives the other four — is the single most important thing a new user can learn.
| Code | Concept | What it is - and what it drives downstream |
|---|---|---|
| PO | Positions | Templates that define a role. Selecting a Position at onboarding creation auto-populates Compliance Rules, Contract type, Credential requirements and Training assignments. |
| CR | Compliance Rules | The documents, credentials and training a Position requires before a worker can start. Set once per Position, reused for every worker in that role. |
| CT | Contracts | The employment or engagement agreement generated and signed as part of the onboarding. Auto-populated from the Position’s Contract template. |
| CD | Credentials | Licences, certifications and checks (background checks, work rights) tracked per worker. A pending result can pause the onboarding workflow. |
| TR | Training | Induction and compliance training assigned automatically and completed by the worker before HR sign-off. |
| Key principle Position drives everything downstream. Get Positions and Compliance Rules right before the first real onboarding - fixing them once workers are mid-flow is significantly harder than fixing them upfront. |
|---|
Roles and Access Model
Onboard has three roles. Each has a distinct scope of ownership, and each is deliberately narrower in some areas - the reasons are stated below so the model reads as intentional design, not an arbitrary restriction.
Super Administrator - full platform configuration
Builds the global foundation everything else is built from: activates Onboard for a company, configures Global Documents/Letters/Credentials and Message Templates, manages other Super Administrator accounts, and controls the Xemplo API Library and System Settings.
Intentionally limited: Background Checks, Contracts and Payroll information are view-only for Super Administrators, because they operate across every company in the instance — day-to-day onboarding ownership sits with the company.
Company Administrator - full company configuration
Owns the foundation within their company: Positions, Compliance Rules, Contract templates, Background Check provider setup, and induction Training courses. Manages HR Managers, Recruiters, Team Managers and Signing Manager access. Has full (not view-only) access to every worker record in the company.
HR Manager - day-to-day onboarding operations
Creates onboardings, tracks them to completion, and reviews and approves what workers submit. Cannot modify system configuration (Positions, Compliance Rules, Contract templates) or manage other users’ permissions — that sits with the Company Administrator.
Role Access Matrix
| Feature / Access | Super Admin | Company Admin | HR Manager |
|---|---|---|---|
| Product Activation | ✓ | ✗ | ✗ |
| Manage Super Admin accounts | ✓ | ✗ | ✗ |
| Manage other user accounts | ✓ | ✓ | ✗ |
| Global Documents / Letters / Credentials | ✓ | ✗ | ✗ |
| Xemplo API Library and System Settings | ✓ | ✗ | ✗ |
| Company configuration (Positions, Contracts, Compliance Rules) | ✓ | ✓ | ✗ |
| Worker Onboarding records | ✓ | ✓ | ✓ |
| Worker Background Checks | View only | ✓ | ✓ |
| Worker Contracts | View only | ✓ | ✓ |
| Worker Payroll information | View only | ✓ | ✓ |
| Hire / Recruitment | ✗ | ✓ | ✗ |
| Integrations and Xemplo Connect | ✓ | ✓ | ✗ |
| Onboarding Report | ✓ | ✓ | ✓ |
| Where to get help Super Administrators: platform and global configuration. Company Administrators: company setup and oversight. HR Managers: day-to-day onboarding. Point each role to its own guide extract rather than the full master guide for daily use. |
|---|
Process Lifecycle
An onboarding moves through six stages from setup to a completed worker record ready for Employ.
| # | Stage | Owner | What happens |
|---|---|---|---|
| 1 | Set up Compliance Rules and Positions | Company Admin | Done once per role, then reused for every worker in that Position |
| 2 | Create the onboarding | HR Manager | New or existing worker; Position and Contract selected |
| 3 | Review, sign and release | Signing Manager | Reviews and signs the contract before it reaches the worker |
| 4 | Worker completes their steps | Worker (self-service) | Account, contract, work rights, profile, training |
| 5 | HR reviews and approves | HR Manager | Checks every submitted step before sign-off |
| 6 | Onboarding completed | System | Worker record is ready for Employ |
Worker self-service - 7 steps
Workers complete the following themselves through the portal, with no admin chasing paperwork:
- Activate account
- Sign contract
- Work rights check
- Complete profile
- Review documents
- Induction training
- Submit for HR review
Step-by-Step Procedures
Procedures are grouped by who performs them and how often - Setup tasks are done once by an administrator; Operate tasks are done repeatedly, mainly by the HR Manager.
SETUP - Activating Onboard for a new company (Super Administrator)
- Navigate to Global Configuration → Product Activation
- Select the company and enable the Onboarding product
- Confirm Xemplo Connect is enabled, if the company needs integrations feeding into onboarding (e.g. background check or ATS providers)
- Hand off to the Company Administrator to begin Position and Compliance Rule setup
SETUP - Configuring global templates (Super Administrator)
- Go to Global Configuration → Global Documents / Global Letters / Global Credentials
- Upload the master templates — standard policy documents, credential definitions — available to every company
- Set Global Message Templates for system-level notifications
Company Administrators will reference these when building company-specific Compliance Rules and Positions.
SETUP - Building a Position with Compliance Rules (Company Administrator)
- Go to Positions and create a new Position
- Attach the relevant Contract template
- Add Compliance Rules — required documents, credentials, training modules and background checks for that Position
- Save — this Position is now ready to be selected whenever HR creates an onboarding
SETUP - Assigning Signing Manager access (Company Administrator)
- Open the user’s account
- Grant Manager access rights
- Confirm they appear as an available Signing Manager option when an onboarding is created
| Important This is the single most common setup blocker at go-live. Verify Signing Manager access during setup week — not on the day. |
|---|
OPERATE - Creating an onboarding (HR Manager)
- Choose worker type — New Worker creates the record from scratch; Existing Worker selects someone already in Xemplo
- Select the correct Position — this determines Compliance Rules and Contract template automatically, the most important choice you make
- Enter contact details carefully — mobile and email drive account activation and 2FA; a typo here locks the worker out
- Assign a Signing Manager — must have Manager access rights; verify during setup, not at go-live
- Review and send — check the auto-populated Contract and Compliance Rules, then send the onboarding to the worker
| Important Position drives everything downstream. If the wrong Position is selected, raise it with your Company Administrator before the worker starts their steps. |
|---|
Status / State Reference
Every onboarding moves through a defined set of statuses. Use the Onboarding Report to see where each one sits and to spot anything stalled.
| Status | Indicator | What it means |
|---|---|---|
| Draft | ○ | Created but not yet sent to the Signing Manager |
| Pending Signing | ● | Waiting on the Signing Manager to review and sign |
| Sent to Worker | ● | Contract signed and released; worker has been invited |
| Offer Accepted | ● | Worker has activated their account and accepted |
| Declined | ✕ | Worker declined the offer |
| In Progress | ● | Worker is working through their self-service steps |
| Background Check | ◌ | Waiting on background check or work rights results |
| HR to Review | ◉ | Worker has submitted everything — your turn to review |
| Completed | ✓ | Fully reviewed and approved — ready for Employ |
| Cancelled | — | Onboarding has been withdrawn before completion |
| Key principle “HR to Review” is a checkpoint, not the finish line. Review each submitted step rather than reaching straight for Approve All. Use Mark Incomplete on a specific step to send it back — don’t reject the whole onboarding. |
|---|
| Critical — irreversible action A Cancelled onboarding cannot be reactivated. If a worker still needs to start, a new onboarding must be created from scratch. Treat Cancel as a point of no return, not a pause button. |
|---|
Stalled Onboard Diagnostic
Onboarding is the highest-volume, highest-confusion moment across the whole Xemplo suite, and a stalled onboard is the single most common support trigger. Use this status-first diagnostic before raising a ticket.
| Stuck at status | Likely cause | Action |
|---|---|---|
| Draft | Never actually sent to the Signing Manager | Send it, or confirm with the creator whether it was meant to be sent yet |
| Pending Signing | Signing Manager hasn’t reviewed it, or lacks Manager access rights | Confirm Manager access rights are granted; follow up with the Signing Manager directly |
| Sent to Worker | Worker hasn’t opened or actioned the invitation | Check the invitation actually arrived; confirm mobile/email are correct; resend if needed |
| Offer Accepted | Worker has accepted but not started their self-service steps | Confirm the worker knows what’s expected of them next; check for a login issue |
| Background Check | Check not yet submitted to the provider, or provider delay | Confirm with the provider whether the check has actually been submitted, not just initiated |
| HR to Review | Waiting on HR action — this is HR’s turn, not the worker’s or Signing Manager’s | Review each submitted step; use Approve All only once genuinely checked, or Mark Incomplete on the specific step at fault |
Review, Approval and Governance Actions
Approve All
Use Approve All only once you’ve genuinely reviewed the content submitted — it’s a convenience for when everything checks out, not a default action. Approving everything at once is faster, but it’s also how compliance gaps slip through; spot-check documents and credentials even when the worker has marked them complete.
Mark Incomplete
Use Mark Incomplete on a specific step to send it back to the worker for correction. This keeps the rest of the onboarding in place — you are not rejecting the whole onboarding, just the one step that needs fixing.
What the worker sees
Workers can see their own onboarding status at any time. If a worker contacts an HR Manager for an update, check their step in the Onboarding Report first before investigating further.
Compliance and Monitoring
Ongoing monitoring is what keeps Onboard reliable at scale after go-live, and is owned by the HR Manager with monthly review by the Company Administrator.
- Monitor the Onboarding Report for onboards stuck in Draft, Pending Signing, or HR to Review
- Spot-check completed onboards against Compliance Rules to confirm nothing was missed
- Collect feedback from HR Managers and from the first cohort of workers
- Review and refine Positions and Compliance Rules based on real usage
- Schedule a 30-day check-in to confirm the process is sticking
Hints, Tips and Common Pitfalls
Before you go live
- Position drives everything downstream — get Compliance Rules right before the first real onboarding; fixing them mid-flow is much harder
- The Signing Manager needs Manager access rights to sign contracts — verify during setup, not in go-live week
- Build Compliance Rule templates once per Position, not per worker — this is what makes onboarding fast at scale
- Load induction Training content before go-live so it’s automatically assigned
When you create each onboarding
- Contact details must be 100% accurate — a typo in mobile or email is the single biggest cause of “worker can’t log in” tickets
- You can’t select an existing worker who already has an unfinalized onboarding open — cancel or complete it first
- Choose New Worker vs. Existing Worker deliberately — it changes what’s captured upfront
Worker experience
- A Background Check or Work Rights check can pause the workflow while results come back — set expectations with the worker about timing
- Workers can see their own onboarding status at any time — point them to their dashboard before investigating further
Review and approval
- “HR to Review” isn’t the finish line — it’s a checkpoint; review each step rather than reaching for Approve All by default
- Use Mark Incomplete to send a specific step back, rather than rejecting or restarting the whole onboarding
Document uploads
- File Uploads is one of the most-read Help Centre articles for Onboard — expect workers to have questions about accepted file types, size limits, and how to redo a rejected upload. Set this expectation upfront rather than waiting for a support ticket
| Rule of thumb If something in Onboard feels slow or stuck, the cause is almost always upstream — in Compliance Rules, Positions, or contact details — rather than the platform itself. Start troubleshooting at the foundation, not the symptom. |
|---|
Troubleshooting Guide
Most issues trace back to contact details, Signing Manager access, or an existing unfinalized onboarding for the same worker.
| Symptom | Likely cause | Resolution |
|---|---|---|
| Worker can’t activate their account | Typo in mobile number or email | Check and correct contact details — this resolves the majority of activation issues |
| Onboarding stuck in Draft | Never actually sent to the Signing Manager | Confirm it was sent; Draft onboards that were never released sit there indefinitely |
| Onboarding stuck at Background Check | Check not yet submitted to provider | Confirm with the provider whether the check has actually been submitted, not just initiated |
| Can’t create a new onboarding for someone | An incomplete onboarding already exists for that worker | Cancel or complete the existing onboarding first, then re-select the worker |
| Worker can’t see a Credential or Training requirement | Requirement is inherited from Position, not set per worker | Check the Position assigned to the worker rather than the individual record |
Implementation and Go-Live Checklist
Work through each phase in order. Foundation setup must be complete before creating a test onboarding - Positions and Compliance Rules drive everything downstream.
Phase 1 - Foundation Setup
Owner: Company Administrator, with Super Administrator support for global configuration
- Confirm which roles will manage onboarding day-to-day (HR Manager, Recruiter, Team Manager) and who will act as Signing Manager
- Grant Manager access rights to whoever will sign contracts as Signing Manager
- Define Compliance Rules for each worker type
- Build Position templates and link each Position to its Compliance Rules
- Configure Contract templates for each employment/engagement type
- Set up Background Check provider/process if used
- Load induction Training content that should be assigned automatically
- Configure invitation email/SMS templates with correct company branding
- Confirm Global Documents, Letters and Credentials templates are in place (Super Administrator)
Phase 2 - Implementation and Testing
Owner: HR Manager, supported by Company Administrator
- Create a test onboarding for a sample new worker (New Worker path)
- Walk through the worker’s 7-step self-service flow end-to-end
- Test the Signing Manager review → sign → release step
- Test the HR Manager review step — try both Approve All and marking an individual step Incomplete
- Confirm invitation email/SMS arrives and links work correctly
- Validate mobile number and email formatting trigger activation/2FA correctly
- Test onboarding an Existing Worker and confirm the system blocks a worker with an unfinalized onboard already open
- Confirm Background Check and Work Rights steps pause/resume the workflow as expected
Phase 3 - Training and Go-Live
Owner: Head of Enablement / Implementation Lead
- Run the Onboard workshop training session for HR Managers, Recruiters and Signing Managers
- Distribute the role-specific guides: Super Administrator, Company Administrator, HR Manager
- Communicate the new onboarding process to workers
- Agree a go-live date and freeze non-critical configuration changes
- Confirm a support escalation path is in place for go-live week
Phase 4 - Post Go-Live
Owner: HR Manager, reviewed monthly by Company Administrator
- Monitor the Onboarding Report for onboards stuck in Draft, Pending Signing or HR to Review
- Spot-check completed onboards against Compliance Rules
- Collect feedback from HR Managers and the first cohort of workers
- Review and refine Positions and Compliance Rules based on real usage
- Schedule a 30-day check-in
Project Sign-Off
| Section | Owner | Date Completed | Notes |
|---|---|---|---|
| 1. Foundation Setup | |||
| 2. Implementation and Testing | |||
| 3. Training and Go-Live | |||
| 4. Post Go-Live (30-day) |
Downstream Asset Map
Per the Xemplo Best Practice User Guide Framework, this master guide is the single source that other Onboard assets are derived from — not rewritten independently. Use this map when producing or updating any of them.
| Downstream asset | Draws primarily from |
|---|---|
| Workshop Training (PPTX, 15 slides) | Overview, Core Concepts, Process Lifecycle, Roles (summary), 3 hands-on exercises from Step-by-Step Procedures, Hints and Pitfalls, Resources |
| Super Administrator Guide | Roles and Access Model (Super Admin slice), Step-by-Step Procedures tagged Setup / Super Admin, Access Reference matrix |
| Company Administrator Guide | Roles and Access Model (Company Admin slice), Step-by-Step Procedures tagged Setup / Company Admin, Access Reference matrix |
| HR Manager Guide | Roles and Access Model (HR Manager slice), Step-by-Step Procedures tagged Operate, Status Reference, Review and Approval, Troubleshooting |
| Hints and Tips | Section 9 in full, re-sequenced by process stage |
| LMS Question Bank | Core Concepts (definition-matching), Status Reference (matching/sequencing), Access Model (scenario questions), Troubleshooting (diagnostic scenarios), Governance Actions (judgement questions) |
| Instructional Videos | Process Lifecycle (stage walkthroughs), Step-by-Step Procedures (screen-recording scripts), Troubleshooting (short “common issue” segments) |
| Xemplo User Guide (Journey-Based) — Journeys C and D | This master guide is the internal-training source; Journeys C and D in the customer-facing guide draw on the same Step-by-Step Procedures and Stalled Onboard Diagnostic, rewritten for a worker-facing, plain-language audience |
Resources and Support
- Help Centre — support.xemplo.com — step-by-step articles for every Onboard workflow
- Company Administrator Guide — for configuration changes outside HR Manager access
- Super Administrator Guide — for platform activation and global template setup
- Implementation and Go-Live Checklist — the full rollout checklist, used before and after go-live
- Hints and Tips — practical guidance from real Onboard rollouts, organised by stage
- Support ticket — for anything the guides don’t cover, raised via support.xemplo.com
Source material reference (support.xemplo.com)
Per the Content Briefs v3 confidence key: ✅ confirmed article · 📁 section landing page, articles to be confirmed · ❌ no existing source, new writing required.
| Confidence | Article / section |
|---|---|
| ✅ | Onboarding the recommended HR starting point |
| ✅ | Onboarding Status full status definitions (richest existing source) |
| ✅ | My Onboarding the worker-side self-service view |
| ✅ | File Uploads one of the most-read articles on the Help Centre |
| 📁 | Work Rights |
| 📁 | Background Checks |
| 📁 | Compliance |
| ❌ | Stalled-onboard diagnostic (status → cause → action) not previously documented; built out in Section 6 of this guide |