EmployeeOnboarding
Flows and blocks for onboarding employees.
import { EmployeeOnboarding } from '@gusto/embedded-react-sdk'
🚂 Workflows
| Component | Description |
|---|---|
| OnboardingExecutionFlow | Guided flow to onboard an employee. |
| OnboardingFlow | Guided flow to onboard multiple employees, one at a time. |
| SelfOnboardingFlow | Guided flow for employees to complete their own onboarding. |
🧩 Blocks
| Component | Description |
|---|---|
| Compensation | Onboarding step for collecting an employee's role and compensation details. |
| Deductions | Onboarding step for collecting an employee's post-tax deductions and court-ordered garnishments. |
| DocumentList | Lists the employee's documents pending signature. |
| DocumentSigner | Onboarding step for signing employee documents. |
| EditCompensation | Renders a form for creating or editing one of an employee's jobs together with its compensation. |
| EmployeeDocuments | Onboarding step for selecting which documents the employee must complete. |
| EmployeeList | Renders a paginated list of a company's employees with per-row onboarding actions (edit, delete, review, cancel self-onboarding) and an "Add employee" entry point. |
| EmploymentEligibility | Captures the employee's I-9 employment eligibility (Section 1) before signing. |
| FederalTaxes | Onboarding step for collecting an employee's federal tax (W-4) withholdings — filing status, multiple-jobs flag, dependents, other income, deductions, and extra withholding. |
| I9SignatureForm | Presents the employee's I-9 form for review and signature. |
| JobsList | Lists an employee's jobs alongside their compensation details, with controls to add, edit, or remove a job. |
| Landing | Landing page for the employee self-onboarding flow. Displays a welcome message and the list of onboarding steps the employee needs to complete. |
| OnboardingSummary | Displays a summary of an employee's onboarding status, listing completed and outstanding steps. Rendered as a standalone step inside OnboardingFlow. |
| PaymentMethod | Onboarding step for setting up an employee's payment method. |
| Profile | Onboarding step for collecting an employee's basic profile and addresses. |
| SignatureForm | Presents a single employee document for review and signature. |
| StateTaxes | Onboarding step that collects an employee's per-state tax withholding answers. The set of fields is driven by the API response for each state on record. |