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

# Leave Policies

> Configure leave types with accrual rules, balance limits, and carryover settings for the organization.

The Leave Policies page, at route `/hr/leave-policies`, lets authorized users configure and manage leave policy definitions.

## Overview

Policies are displayed in three tabs — **Active**, **Inactive**, and **All** — each showing a badge count. The active tab is the default. A `LeavePoliciesList` component renders the filtered list. Users with `hr.leave.manage` permission see an **AccrualRunDialog** button alongside the standard **Add Policy** button. Selecting **Add Policy** opens a `LeavePolicyFormDialog`.

## Who it's for

Requires `HR_PERMISSIONS.LEAVE_POLICIES_VIEW`. The **Add Policy** and **AccrualRunDialog** controls require `hr.leave.manage`.

## Before you start

* Determine the accrual schedule and carryover rules before creating a policy.
* Employees will not see or use a policy until it is active and assigned.

## Steps

1. Go to **HR → Leave Policies**.
2. Review active policies in the **Active** tab.
3. Select **Add Policy** to create a new leave type with accrual settings.
4. To deactivate a policy, edit it and toggle its active state.
5. If you have manage permission, use the **AccrualRunDialog** to trigger a manual accrual calculation.

## Key concepts

| Concept      | Meaning                                                                               |
| ------------ | ------------------------------------------------------------------------------------- |
| Accrual rule | Defines how leave hours accumulate over time (SME: confirm frequency and cap fields). |
| Carryover    | Determines how unused balances are handled at period rollover.                        |
| AccrualRun   | A manual trigger to recalculate accrual balances (SME: confirm scope).                |

## 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.tsx
  * src/cores/hr/pages/LeavePolicies.tsx
  * src/cores/hr/hooks/leave/useLeavePolicies.ts
  * src/cores/hr/components/leave/LeavePoliciesList.tsx
</Accordion>