This article describes the key features of Swif's team-level onboarding checklists and how employee onboarding status works once the checklist is moved into Settings → Teams.
Overview
Swif lets you define custom onboarding checklists per team and (optionally) per user group within a team. These checklists drive the employee’s Onboarding / Active status and surface as a status tag on the employee card/list.
This update moves onboarding configuration away from a single, organization-wide checklist and makes onboarding:
Team-specific (each team controls its own checklist).
User-group aware (optional templates per user group).
Directly linked to employee status (“Onboarding” vs “Active”).
Easier to manage before, during, and after the system default onboarding.
1. Onboarding Checklists at the Team Level
1.1 New Team Settings Location
Instead of a global onboarding checklist at the organization level, onboarding is now configured under Teams:
The old Team page is repurposed into:
Settings → Team → Members & RolesA new tab is added:
Settings → Teams → Onboarding Templates
From here, admins manage onboarding and offboarding templates for each team.
1.2 Onboarding Templates
In Settings → Teams → Onboarding Templates, you can:
Create a new checklist template (Onboarding Templates 1.1.0).
Manage existing templates for:
Team-level templates (applies to the entire team).
Group-level templates (applies only to specific user groups within that team).
The templates table includes a User Group column and a tooltip explaining how templates behave for teams vs user groups.
Note: Offboarding templates are still supported, but the core of this feature focuses on onboarding. Offboarding enhancements may be covered by separate updates.
2. Team-Level vs Group-Level Templates
Swif supports two scopes for onboarding templates:
2.1 Team-Level Templates
Scope: Entire team.
Configuration rule:
For each team, you can have:Exactly 1 onboarding template, and
Exactly 1 offboarding template
whenuserGroupIds = null(no user group filter).
Use this when you want one universal checklist for all new hires in that team.
2.2 Group-Level Templates (User Group–Specific)
Scope: Specific user groups within a team (e.g., “Engineering”, “Sales”, etc.).
Configuration rule:
For each user group, you can have:Only 1 onboarding template, and
Only 1 offboarding template
whenuserGroupIdscontains that group’s ID.
Use this when different roles within the same team require different onboarding steps.
3. Removal of Global (Org-Wide) Onboarding Checklists
Previously, there was a single, organization-wide onboarding checklist under Settings → General → Onboarding Checklist.
With this update:
The org-wide onboarding checklist is removed.
The Onboarding Checklist section is no longer available in Settings → General.
All onboarding behavior is now driven by the team-level templates (and optionally, group-level templates).
This gives each team full control over its own onboarding process.
4. Accessing Custom Checklists Before System Onboarding
Swif includes a system default onboarding flow, but it should no longer block your custom team checklists.
With this change:
Custom onboarding checklists are accessible and actionable at any time, regardless of whether the system default onboarding has been completed.
The system default onboarding is now optional and skippable.
Any frontend dependency that previously required system default onboarding to be completed before showing custom checklists has been removed.
In practice, this means:
Admins can immediately start working through the team’s custom checklist for a new hire.
The system default flow (e.g., a “Start Onboarding” button) does not need to be completed for checklists to be visible or editable.
5. Employee Status and Onboarding Tag
5.1 Default Status for New Employees
Employee status is now directly driven by whether the team has a customized onboarding checklist:
If a team has a customized checklist:
New employee → Status: Onboarding
If a team has no customized checklist:
New employee → Status: Active
5.2 Status Tag on Employee Card/List
A status tag is shown on the employee card/list (as per the “Onboard Employee 1.0.0” Zeplin design). This tag:
Clearly indicates whether the employee is Onboarding or Active.
Is styled according to the updated design system.
Updates dynamically as checklist items are completed.
5.3 Hiding the “Onboard Employee” Button
To avoid confusion once an employee is fully onboarded:
If the employee status is Active, the “Onboard employee” button is hidden in the UI.
Admins rely instead on the status tag and checklist completion rather than manually re-triggering onboarding.
6. Checklist Completion Logic
The employee’s status changes based on completion of the team’s checklist:
6.1 If a Team Has a Customized Checklist
When a team has at least one onboarding checklist template applied:
New employee
Status: Onboarding
Some checklist items done, but not all
Status: Onboarding
All checklist items done
Status: Active
The frontend uses the underlying API to update the employee status (e.g.,
changeEmployeeStatus).
This ensures the employee only becomes Active once all required onboarding tasks for that team are completed.
6.2 If a Team Has No Customized Checklist
If there is no custom checklist defined for a team:
New employee
Status: Active
System default onboarding not done
Status: Active
System default onboarding completed
Status: Active
In other words, system default onboarding has no impact on status when there is no team-level checklist. The employee remains Active by default.
7. Email Reminders for Onboarding Checklists
To help teams stay on top of onboarding:
When a new employee with team onboarding TODOs is created, their status becomes Onboarding, and
The system sends email reminders to team admins to complete the onboarding checklist.
Key points:
Reminders are targeted at admins responsible for that team.
The email content focuses on outstanding checklist items.
The actual triggering and delivery of emails are handled automatically by the backend once the frontend updates the employee status/checklist state.
8. Post-Release Behavior & Migration
After this feature is released, two important behaviors ensure a smooth transition:
Migration from Org-Level to Team-Level
Once the frontend changes are live, the backend can copy existing organization-level customized checklists into team-level customized checklists, so you don’t lose your old configuration.
Correct Status Behavior in Real Scenarios
Swif expects the following:
Scenario 1: Team has a customized checklist
New employee → Status: Onboarding
Some items completed → Status: Onboarding
All items completed → Status: Active
Scenario 2: Team has no customized checklist
New employee → Status: Active
System default onboarding not done → Status: Active
System default onboarding done → Status: Active
These rules guarantee that only team-level checklists control whether an employee is considered “Onboarding” or “Active”.
9. Error Handling & Edge Cases
The feature includes handling for common edge cases:
Checklists and status tags remain consistent even if:
Checklist items are added, removed, or reordered over time.
The team’s template changes while employees are mid-onboarding.
The employee status is refreshed correctly when:
All remaining required items are marked done.
A final checklist item is removed (logically completing the checklist for that employee).
From the admin’s perspective, the experience is:
Simple: Status and tag follow the checklist.
Predictable: Teams know exactly when someone is considered fully onboarded.
Resilient: UI continues to behave correctly even when checklists change.
Summary
With team-level onboarding checklists:
Onboarding is owned by the team, not the entire organization.
Custom checklists (per team and/or per user group) directly control the Onboarding / Active status.
A dynamic status tag on the employee card/list keeps everyone informed.
The system default onboarding is optional and never blocks access to checklists.
Email reminders help ensure onboarding tasks don’t fall through the cracks.
This provides a more flexible, accurate, and transparent onboarding experience for both admins and employees.

