> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Enroll in Benefits

> Multi-step wizard for employees to select benefit plans, add dependents, and submit or waive benefits enrollment during an open enrollment period.

The Enroll in Benefits page (`/hr/my-benefits/enroll`) guides employees through a four-step wizard to review eligibility, select or waive benefit plans, manage dependents, review cost breakdowns, and submit enrollment during an active open enrollment window.

## Overview

The wizard uses four steps:

1. **Eligibility** — displays the active enrollment period details and the count of eligible and ineligible plans. The employee must confirm their eligibility before proceeding.
2. **Plan Selection** — shows eligible plans with coverage level options and premiums. Employees can toggle individual plans, select coverage levels, or elect to waive all coverage (requires a waiver reason).
3. **Dependents** — for each selected plan, employees assign dependents or add new dependents via the Dependent Form dialog. Skipped when coverage is waived.
4. **Review** — shows a full cost breakdown of selected plans, dependent assignments, and employer contributions. Employee must accept terms before submitting.

Progress is auto-saved as a draft every 2 seconds. If a previous draft exists, it is restored on page load with a toast notification. Existing enrollments are pre-populated when no draft is present.

If no open enrollment period is active, the page redirects to `/hr/my-benefits` with an error toast.

## Who it's for

Access follows your organization's role and module configuration. ## Before you start

* Open enrollment must be active for your organization.
* You must be linked to an employee record via your user profile.
* Dependents can be added during step 3 if not already created.

## Steps

1. Navigate to **HR → My Benefits → Enroll** or go to `/hr/my-benefits/enroll`.
2. **Step 1 — Eligibility**: Review eligible plan count and confirm your eligibility.
3. **Step 2 — Plan Selection**: Select plans and coverage levels, or elect to waive coverage and provide a reason.
4. **Step 3 — Dependents**: Assign dependents to each selected plan or add new dependents.
5. **Step 4 — Review**: Review all selections, cost breakdown, and accept the terms.
6. Click **Submit Enrollment** to finalize.

## Key concepts

| Concept                | Meaning                                                                          |
| ---------------------- | -------------------------------------------------------------------------------- |
| Open enrollment period | The date window defined by HR during which enrollment changes are accepted       |
| Coverage waiver        | Opting out of all benefit plans; requires a written reason                       |
| Draft save             | Enrollment progress is auto-saved; restored on next visit during the same period |

## Related

<Columns cols={2}>
  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/hr/benefits-routes.tsx
  * src/cores/hr/benefits/pages/employee/EnrollmentWizardPage.tsx
  * src/cores/hr/benefits/hooks/useBenefitEnrollmentMutation.ts
  * src/cores/hr/benefits/hooks/useOpenEnrollmentPeriods.ts
</Accordion>
