Adding a New Employee
1
Navigate to Employees
Go to People > Employees or
/people/employees2
Click Add Employee
Click the Add Employee button in the top right
3
Fill in Details
Complete the employee information form
4
Submit
Click Add Employee to create their account
Required Information
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:
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
1
Review Information
Verify the form data and signature are correct
2
Click Approve
Click the Approve button on the document
3
Confirmation
The status changes to Approved with a timestamp
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
Status Reference
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