Adding a New Employee
Required Information
| Field | Description |
|---|---|
| Full Name | Employee’s legal name |
| Used for login and communications | |
| Job Title | Their position at the company |
| Department | Select from dropdown |
| Worker Type | Employee, Contractor, or Temporary |
| Hire Date | Official start date |
What Happens Next
When you add an employee, the system automatically:- Creates a user account with temporary password
- Generates an Employee ID (format:
ST-XXXX) - Sets their status to
pending_confirmation - Sends an invitation email to complete onboarding
The employee will receive an email with a link to access the onboarding portal at
/onboardingTracking Onboarding Progress
Onboarding Dashboard
Navigate to People > Onboarding or/people/onboarding to see:
| Metric | Description |
|---|---|
| Pending Onboarding | Employees still completing steps |
| Fully Onboarded | Employees with active status |
| Total Employees | All employees in the system |
Filtering Employees
Use the filter buttons to view:- All - All employees regardless of status
- Pending - Only employees with incomplete onboarding
- Completed - Only fully onboarded employees
Employee Detail View
Click on any employee to view their detailed onboarding status at/people/onboarding/[employeeId]:
- Progress bar showing completed steps
- Timestamp for each completed step
- List of submitted documents
Reviewing Documents
Document Tab
From the employee detail view, click the Documents tab to see all submitted documents. Each document shows:- Document type (W-9, W-4, Direct Deposit)
- Submission date and time
- Electronic signature
- Current approval status
Approving Documents
Rejecting Documents
If a document needs corrections:- Click Reject on the document
- The employee is notified to resubmit
- They can submit a corrected version from their portal
Re-onboarding an Employee
To have an existing employee go through onboarding again:- The employee appears in the Pending filter
- They can access
/onboardingto complete steps again - All previous timestamps are cleared
Onboarding Steps Reference
| Step | Name | Database Field |
|---|---|---|
| 1 | Sign Documents | — |
| 2 | Code of Ethics | code_of_ethics_signed_at |
| 3 | W-9 Form | w9_submitted_at |
| 4 | Tax Withholding | tax_withholding_submitted_at |
| 5 | Direct Deposit | direct_deposit_submitted_at |
Status Reference
| Status | Database Value | Meaning |
|---|---|---|
| Pending | pending_confirmation | Onboarding in progress |
| Active | active | Onboarding complete |
| Suspended | suspended | Account disabled |
Troubleshooting
Employee not appearing in onboarding list
Employee not appearing in onboarding list
- Check the All filter to see all employees
- They may already have
activestatus - Verify their record exists in the database
Documents not showing for employee
Documents not showing for employee
- Confirm the employee has accessed the onboarding portal
- Check that they’ve actually submitted documents
- Verify the document types match (
w9,w4,direct_deposit)
Onboarding step not advancing
Onboarding step not advancing
- Check for browser console errors on employee’s device
- Verify RLS policies allow updates to the
driverstable - May need to manually update
onboarding_stepvia database
Employee didn't receive invitation email
Employee didn't receive invitation email
- Verify the email address is correct
- Check their spam/junk folder
- Resend the invitation from the employee detail page