Leave Days Policy
=================

The leave days policy lets you automatically award employees a more generous annual leave entitlement as their tenure grows. Rather than manually reassigning leave types when someone reaches a milestone, TeamHub migrates employees to the correct leave type for you on each work anniversary.

How It Works
------------

The policy is a table that maps **years of service** to an **annual leave type**. A simple example:

+----------------+-------------------------------+
| Years Service  | Annual Leave Type             |
+================+===============================+
| 0+             | Annual Leave (15 days)        |
+----------------+-------------------------------+
| 5+             | Annual Leave (Senior, 20 days)|
+----------------+-------------------------------+

When an employee's work anniversary falls and they have now reached a new milestone (e.g. their 5th year), TeamHub automatically migrates them from their current annual leave type to the one specified for that milestone. Their balance history, approved leave, and reports carry over seamlessly.

The 0+ row is always present and acts as the default — it is the leave type assigned to all new employees from day one.

Setting It Up
-------------

The leave days policy is configured at the company level and requires assistance from a TeamHub administrator. You will need to:

1. Decide the tenure milestones (e.g. 5 years, 10 years) and the leave type that applies at each.
2. Ensure each target leave type already exists under **Settings → Leave Types** with the correct days and accrual behaviour configured.
3. Contact `support </support>`_ to add the policy rows to your company.

Once configured, the system handles all future migrations automatically — no per-employee setup is needed.

When Migration Happens
----------------------

Migration runs once per employee per year, on their **work start anniversary**. The system checks the policy table, determines which leave type applies to the employee's new years-of-service count, and moves them if they are not already on the correct type.

If an employee is already on the correct leave type (e.g. they were manually assigned the senior type early), no migration occurs.

Frequently Asked Questions
--------------------------

**Will an employee lose their current leave balance when they are migrated?**
   No. Migration carries the existing balance forward. The employee's opening balance, accruals, and any adjustments are transferred to the new leave type, effective from their anniversary date.

**What if we add a new policy row after some employees have already passed that milestone?**
   Existing employees will be migrated at their next anniversary. If you need an immediate catch-up, contact support to trigger a manual recalculation.

**Can we have different policies for different groups of employees?**
   The leave days policy applies company-wide. If different groups need different milestones, the most common approach is to configure separate leave types for each group (e.g. "Annual Leave — Staff" and "Annual Leave — Management") and speak to support about how to structure the policy rows.

**What happens if no leave days policy is configured?**
   Employees stay on whichever leave type they were originally assigned. No automatic migration will occur. If you see a notice on the Settings page indicating no policy is configured, contact `support </support>`_ to get one set up.