> ## 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.

# Benefits

> Employee self-service benefits dashboard showing active enrollments, costs, dependents, and open enrollment status.

The Benefits employee self-service dashboard is available at route `/hr/benefits`. Access follows your organization's role and module configuration. ## Overview

The My Benefits Dashboard (`MyBenefitsDashboardPage`) is the employee self-service landing page for benefits at `/hr/benefits`. It shows four summary stat cards: active plan count, employee monthly cost, employer monthly contribution, and covered dependent count. Banners appear for open enrollment periods, pending enrollments awaiting approval, and life event reporting. Active enrollments are grouped by plan type and shown as `EnrollmentSummaryCard` components. Quick-link buttons navigate to Manage Dependents, Enroll in Benefits (if an open enrollment period is active), View All Plans, Benefits Guides, and Benefits Statement. A `BenefitsCostSummary` component shows cost breakdown.

## Who it's for

Access follows your organization's role and module configuration. Note: the admin view for benefits management is at `/hr/benefits/plans`.

## Before you start

* No preconditions; the page shows empty state if no enrollments exist.

## Steps

<Steps>
  <Step title="Open My Benefits">Navigate to `/hr/benefits`.</Step>
  <Step title="Review enrollments">Check active plan count, costs, and covered dependents in the summary stats.</Step>
  <Step title="Enroll during open enrollment">If an open enrollment banner is visible, click **Start Enrollment** or **Make Changes**.</Step>
  <Step title="Report a life event">If eligible and no open enrollment is active, use the **Report Life Event** option from the banner.</Step>
  <Step title="Access related pages">Use quick-link buttons to manage dependents, view guides, or download a benefits statement.</Step>
</Steps>

## Key concepts

| Term                   | Meaning in code                                                           |
| ---------------------- | ------------------------------------------------------------------------- |
| `OpenEnrollmentBanner` | Displays when a current open enrollment period exists                     |
| `LifeEventBanner`      | Displays when no open enrollment is active to prompt life event reporting |
| `enrollment.status`    | `active` or `pending` — pending enrollments await HR approval             |

## 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">
    Documentation coverage and governance.
  </Card>
</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.tsx
  * src/routes/hr/benefits-routes.tsx
  * src/cores/hr/benefits/pages/employee/MyBenefitsDashboardPage.tsx
  * src/cores/hr/benefits/hooks/useBenefitEnrollments.ts
</Accordion>