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

# Life Events

> Admin review queue for employee life event requests that qualify for outside-open-enrollment benefits changes.

The Life Events page, at route `/hr/benefits/life-events`, is an admin queue for reviewing and acting on employee life event enrollment requests.

## Overview

The page shows summary counts for Total, Pending, Approved, Rejected, and Expired events. A tab filter (All, Pending, Approved, Rejected, Expired) narrows the data table. Each row displays the employee (with avatar), event type badge, event date, status badge, and submission time. Pending rows show a **Review** button; other rows show a **View** button. Selecting either opens a `LifeEventReviewDialog`. A pending-count badge appears in the header when reviews are outstanding.

Supported event types visible in the code: Marriage, Divorce, Birth/Adoption, Death of Dependent, Loss of Coverage, Gain of Coverage, Address Change, Dependent Age Out, Other.

## Who it's for

Requires `hr.benefits.admin`.

## Before you start

* Employees must have submitted life event requests from their **My Benefits** self-service page.
* Review the qualifying event date before approving to ensure it is within the allowable window (SME: confirm window).

## Steps

1. Go to **HR → Benefits → Life Events**.
2. Filter by **Pending** to see requests awaiting review.
3. Select **Review** on a pending event.
4. In the review dialog, approve or reject the request and add review notes.
5. Use **View** on non-pending rows to inspect the history.

## Key concepts

| Concept    | Meaning                                                                                                                         |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Life event | A qualifying life change (marriage, birth, loss of coverage, etc.) that permits benefits enrollment outside of open enrollment. |
| Expired    | The submission window for acting on this event has closed (SME: confirm).                                                       |

## 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/admin/LifeEventsListPage.tsx
  * src/cores/hr/benefits/hooks/useLifeEvents.ts
  * src/cores/hr/benefits/types/lifeEvents.ts
</Accordion>