> For the complete documentation index, see [llms.txt](https://help.allwage.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.allwage.com/modules/payroll/leave.md).

# Leave

Manage accrued and spent leave per employee

The **Leave** module in AllWage enables you to link leave recorded on the [Employee Overview](https://help.allwage.com/modules/time-and-attendance/reports/employee-overview.md) to the employee’s pay run. Within this module, you can:

* Configure leave accrual parameters.
* Manage leave balances.
* Add adjustments.
* Perform leave payouts.

For details on how to capture leave days for an employee, refer to the [Data Capture](https://help.allwage.com/modules/time-and-attendance/data-capture.md#how-to-capture-leave)section.

## Create a new Leave Policy

Create standardised leave policies to efficiently manage rules for different employee groups. By defining policies centrally, you can link them to multiple pay runs, saving time and ensuring consistency.

Follow the steps below to create a new leave policy:

1. Navigate to **Payroll**, then select [Leave Policies](https://app.allwage.com/#/payroll/leave-policies).
2. Click "**Add Leave Policy**".
3. Configure the following properties for the policy:
   * **Policy Name**: Enter a descriptive name. This will help you identify the policy when linking it to pay runs or assigning it to specific employees.
   * **Average Working Hours per Day**: Enter the average number of hours in a standard workday. This is used to calculate leave deductions correctly. If an employee's daily hours vary, use their average for a calendar year.\
     ![](https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2FAnE33k6a1Ny4UDqGVuuq%2Fimage.png?alt=media\&token=ac9d3e8d-af20-470a-8916-8e3227bf5ef9)
   * **Leave should accrue based on**: Choose how leave is earned.\
     ![](https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2FdM2VWPfHtJZEpvktemXI%2Fimage.png?alt=media\&token=1b878028-4333-487f-98e4-03f363283c55)
     * **Present Days Worked**: Leave accrues for each required working day an employee is present, based on any activity on the Employee Overview Report.
     * **Fixed Amount**: Accrues a set number of leave hours per pay period, regardless of actual hours worked. This is ideal for salaried employees or those with fixed leave entitlements.
     * **Hours Worked**: Accrues leave based on an employee's actual clocked hours. Select one or more pay run templates to be included in the calculation.
     * **Fractional Days**: Leave accrues based on the portion of a required workday an employee is present. For example, if an employee works 4.5 hours of a 9-hour day, they will accrue leave for 0.5 days.
   * **Leave Deduction**: Select how leave balances are reduced when leave is taken.
     * **Hourly**: Leave is deducted in hours. When an employee takes a day off, the number of hours equivalent to their standard workday is deducted from their leave balance.
     * **Daily**: Leave is deducted in full-day or partial-day units. Taking a full day of leave deducts one day from the balance, regardless of the employee's scheduled hours for that day.
   * **Annual Leave Configuration**:
     * **Cycle Start Date**: Choose whether the annual leave cycle begins on the employee's appointment date or on a fixed calendar date. A fixed date is useful for aligning all employees to the same leave cycle.\
       ![](https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2FzUEqElgcrRIwKcS3GX4H%2Fimage.png?alt=media\&token=dde3d7ab-6977-4ea3-afa6-209df7180323)
     * **Annual Leave Accumulation Factor**: Enter the rate at which leave is earned. This factor is used in the formula: `(Hours or Days Worked) / Accumulation Factor = Leave Accrued`.
     * **Leave Expiration**: Configure rules for carrying over unused leave. You can specify if leave expires, the maximum number of days to carry over, and when the carried-over leave expires. Carried-over leave is always used first. By default no leave expires.\
       ![](https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2FjQCblQ9da7v0xlSgIeED%2Fimage.png?alt=media\&token=44ff06a0-c8da-4df0-8f3b-aa062f47c91b)
     * **Minimum Leave Balance**: Set a minimum leave balance (0 or a negative number) to prevent employees from taking more leave than allowed. The system will block leave applications that would cause the balance to fall below this limit.\
       ![](https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2FXg6lTEaIhEhPPKdWxwov%2Fimage.png?alt=media\&token=db42710c-4fce-49a5-ba2e-36ae45ca3f7c)
   * **Annual Leave Payout**:
     * **Leave Payout Rate**: Select the rate used to calculate leave pay. This can be an hourly or daily rate based on your system rate configuration. If a custom rate is set for an employee, that rate will be used instead.\
       ![](https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2F8yyjjn4X1DS2gH1FtgqI%2Fimage.png?alt=media\&token=9cbb30b2-f0a9-4925-bbf4-923c874378b9)
   * **Sick Leave Configuration**:
     * **Contractual Workdays per Week**: Enter the number of days the employee is contracted to work each week. This figure is used to calculate the total sick leave entitlement over the cycle.\
       ![](https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2F37DCy7A2CFNGmqNUPV3Z%2Fimage.png?alt=media\&token=ab2aafa7-0284-4736-af10-315ed801ef43)
     * **Minimum Leave Balance**: Set a minimum leave balance (0 or a negative number). The system will block leave applications that would cause the balance to fall below this limit.
   * **Family Responsibility Leave**:
     * **Leave Entitlement (Days)**: Enter the number of Family Responsibility Leave days an employee is entitled to per leave cycle. The statutory minimum is 3 days, but this can be increased. AllWage doesn't save a lower number ("Family Responsibility Leave entitlement cannot be less than 3 days.").\
       ![](https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2F0ISsBebRHjol9BhoXQfJ%2Fimage.png?alt=media\&token=8886068a-b585-444f-b9e2-6d4354de4b04)
     * **Minimum Leave Balance**: Set a minimum leave balance (0 or a negative number). The system will block leave applications that would cause the balance to fall below this limit.
4. Click "**Save**" to create the new leave policy.

## Delete a leave policy

You can't delete a leave policy while it is still in use:

* "Cannot delete Leave Configuration as it is still linked to … Pay Run Template(s).": one or more recurring pay runs use this policy. [Link another leave policy in their Pay Run Settings](https://help.allwage.com/modules/payroll/recurring-pay-runs/pay-run-settings.md#leave-policy-configuration) first.
* "Cannot delete Leave Configuration as it is still linked to … Employee Template(s).": one or more employees have this policy as an override. Change the override first. See [Employee Leave](https://help.allwage.com/modules/payroll/recurring-pay-runs/employee-pay-run-view.md#employee-leave).

## How leave balances build up

Each pay run, AllWage works out every employee's leave balance:

**Closing balance = opening balance + leave accrued − leave taken ± adjustments − payouts**

Expired leave is taken off at the start of each leave cycle.

* **Annual leave** builds up gradually: each pay run adds the leave accrued in that period, using the policy's accrual method and accumulation factor. The year's entitlement is never credited up front, so the balance is what the employee has earned so far.
* **Family responsibility leave** builds up nothing until the employee has been employed for the policy's qualifying period (four months by default). Then the full entitlement is added at once, and again at the start of every 12-month cycle. Unused days don't carry over.
* **Sick leave** is six weeks of the employee's contractual working days in every 36-month cycle. In the first six months, it builds up at 1 day for every 26 worked on policies that accrue by **Fixed Amount** or **Hours Worked**; on **Present Days Worked** and **Fractional Days** policies none builds up before six months. At six months, the rest of the entitlement is added at once.

AllWage doesn't show what an employee's balance will be at the end of the cycle. The [Leave Liability report](https://help.allwage.com/modules/payroll/reports.md#leave-liability) estimates how much leave will expire or carry over at the end of the cycle, based on the current balance.

## Importing Leave Balances

Take-on balances for employees can only be imported when:

* [x] Employees are linked to a pay run with leave configured: [#setup-and-configuration](#setup-and-configuration "mention")
* [x] Have a valid start date or active period: [Employee Pay Run View](https://help.allwage.com/modules/payroll/recurring-pay-runs/employee-pay-run-view.md#creating-a-new-active-period)

### How to import leave opening balances

This video will show you how to download, complete and import the leave balances for your employees. Please see below steps for the step by step break down.

{% embed url="<https://youtu.be/Nj1VY84d_mw>" %}

#### Download the Leave balance sheet

1. Navigate to [**Payroll > Employees**](https://app.allwage.com/#/payroll/employees).
2. Click **Export / Import** on the top right and click **Export**.
3. Under **Leave (Payroll)**, click one of:
   * **Export Leave Take-on Balances**: only employees who don't have finalised leave balances yet. Use it when you start using AllWage leave for new employees.
   * **Export All Leave Balances**: every employee with a start date and a leave policy, with their **Annual**, **Sick** and **Family responsibility** closing balances already filled in where AllWage has them. Use it to correct existing balances.

**What "Export All Leave Balances" contains.** It is the import sheet described below, not a separate report: one row per employee, with their balances in days as at **Balance As of** (the start date of their current pay run), their months employed, cycle dates and threshold flags. It doesn't include leave in the open pay run or rand values. For a report of current balances, use the [Leave Liability](https://help.allwage.com/modules/payroll/reports.md#leave-liability) report instead, which also shows the open pay run's balances, each leave type's history and the annual leave payout liability in rand.

#### Understand the Excel sheet

This will download an excel spreadsheet. This excel file will be prepopulated with all the employees eligible for a leave take on balance. Leave thresholds will also be set according to current employment durations. Please refer to the below items on how to complete the leave balance sheet:

{% hint style="warning" %}
Only employees with **employment start dates** and which is **linked to a leave policy (whether via the pay run config or employee overrides)** will be populated on the export template. If employees are missing, make sure to check their start dates, if they are added to a pay run, and if the leave is configured in that pay run.
{% endhint %}

<figure><img src="https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2FDXazPasHN3HjCI4DGC5e%2Fimage.png?alt=media&amp;token=dfaf7a67-4698-44a6-b392-13e4237bfd05" alt=""><figcaption><p>Leave import template</p></figcaption></figure>

* Employee Details:
  * **Employee #**: Contain the employee number
  * **Existing Leave Balance**: If TRUE, this means that the employee has an existing leave balance which can be updated if it is imported again. If it is FASLE, the values will be the take-on balance for the employee
  * **Months Employed**: The total months since the employee's start date. If this is less than 6 or 4, Sick and Family Responsibility leave thresholds will apply
  * **Balance As of**: The date at which the balances are applicable. This will always be the start date of the employees current pay run
* Leave Balances - Provide the closing balance on the date of "**Balance As of**"
  * **Annual leave closing balance**
  * **Sick leave closing balance**
  * **Family responsibility closing balance**
* **Leave Cycles**: Leave cycles start on the day of employment with the following durations for each leave type. These values are calculated as a reference and cannot be changed:
  * Sick leave cycle start date: 3 years from the start of employment
  * Annual leave: 1 year from the start of employment
  * Family responsibility leave cycle start date: 1 year from the start of employment
* **Leave thresholds** - only applicable to Sick and Family Responsibility Leave
  * **Sick leave threshold crossed** - If indicated as FALSE, the employee needs to be employed longer than 6 months before they will be entitled to their full 6 week leave balance
    * In their first 6 months, employees on a **Fixed Amount** or **Hours Worked** leave policy accrue sick leave at 1 day for every 26 days worked. AllWage works this out in hours: it adds 1 hour of sick leave for every 26 hours worked. The hours worked are the hours from the pay run templates selected on an **Hours Worked** policy, or the fixed hours per pay period on a **Fixed Amount** policy. When an employee works the policy's **Average Working Hours per Day** each day, 26 days of hours accrue one day's hours of sick leave. Example: with 9 hours a day, 26 days is 234 hours worked, which accrues 9 hours, or 1 day. After the 6-month threshold, they receive the full 6-week entitlement.
  * **Family responsibility leave threshold crossed** - If indicated as FALSE, the employee needs to be employed longer than 4 months before they will be entitled to the full 3 days of leave

#### Import the file

1. Navigate to [**Payroll > Employees**](https://app.allwage.com/#/payroll/employees).
2. Click **Export / Import** on the top right and click **Import**.
3. Under **Leave (Payroll)**, click **Import Leave Balances**.
4. Click on Import
5. Locate the excel file that you have edited and click on Open
6. Click on Upload file
7. Click on Next
8. Click on Validate
   1. If there are validations - please check each one. You can edit the item or choose to import it, but if you import it might have repercussions if the wrong balances where added
   2. If there are errors - these will need to be corrected bfore you can continue. You can edit the line item, or edit the excel sheet and re-import the sheet.
9. Click on Import (or Import with warnings).

## Leave Payout Bulk Manage

The **Leave Payout Bulk Manage** feature allows you to efficiently handle leave payouts for multiple employees within a single pay run.

{% hint style="success" %}
To manage leave payouts for a single employee, please refer to this page: [Employee Pay Run View](https://help.allwage.com/modules/payroll/recurring-pay-runs/employee-pay-run-view.md#employee-leave-payout)
{% endhint %}

### Add Bulk Leave Payouts

To get started, navigate to [Payroll > Pay Runs](https://help.allwage.com/modules/payroll/recurring-pay-runs/current-pay-run.md) and select the desired pay run.

<figure><img src="https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2Fr8CS57Ohw8zpNkoZMF7a%2Fbulk%20manage%20leave%20-%20payout.png?alt=media&amp;token=842c5230-c321-4936-bb43-d53c24e82d31" alt="" width="563"><figcaption><p>Access bulk manage option for leave payout</p></figcaption></figure>

1. **Select Employees**: Choose all or specific employees within the selected pay run.
2. Click on **Manage Leave**: Open the Manage Leave section.
3. Select the **Import Payout** Option: This will open the bulk management panel for leave payouts.

<figure><img src="https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2Fcadz3rvbIsW2t52WGCeT%2Fbulk%20manage%20leave%20pyout%20description.png?alt=media&amp;token=f62b4d2c-6246-47d9-9059-34bd7eb309cb" alt="" width="508"><figcaption><p>Add leave description</p></figcaption></figure>

4. Leave Payouts Are Only Applicable for **Annual Leave**
5. Provide a **Description** for the Leave Payout: Add a description that will be linked to all selected employees for transparency.

<figure><img src="https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2FlHKC2GztuoSxD6JHQWsB%2Fbulk%20manage%20leave%20payout.png?alt=media&amp;token=2b93aec7-bfb1-450b-838b-c3b202dc2d07" alt="" width="506"><figcaption></figcaption></figure>

6. **Full Leave Payout**: Pay out all available leave for an employee. This option is only available if the employee’s leave balance is positive.
7. **Partial Leave Payout**: Specify the number of leave days to pay out for an employee.
8. **Bulk Actions**
   * **Copy & Paste**: Copy values from one employee and use the paste option to apply them to other selected employees.
   * **Remove**: Remove specific employees from the bulk management list.
9. **Manage Templates**
   * **Download & Upload Template**: Download an Excel file to bulk edit or import values. Only employees in the current pay run will be included in the list. Any employees not found will be flagged as errors.
   * **Set Uniform Amount**: Use this quick action to apply the same amount to all employees in the list.

Click on Add to save your selection.

### Remove Bulk Leave Payouts

The **Leave Payout Bulk Manage** feature allows you to efficiently handle leave payouts for multiple employees within a single pay run.

To get started, navigate to Payroll > Pay Runs and select the desired pay run.

<figure><img src="https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2FWcVQJzZZ7Ihd4IfmmEkR%2Fbulk%20manage%20leave%20-%20payout%20remove.png?alt=media&amp;token=e7d56452-b0d0-476b-a4da-ac25313ce561" alt="" width="563"><figcaption><p>Remove leave payouts in bulk</p></figcaption></figure>

1. **Select Employees**: Choose all or specific employees within the selected pay run.
2. Click on **Manage Leave**: Open the Manage Leave section.
3. Select the **Remove Payouts** Option: This will all leave payouts for the selected employees.

## Leave Adjustments Bulk Manage

The **Leave Adjustment Bulk Manage** feature allows you to efficiently handle leave payouts for multiple employees within a single pay run.

{% hint style="success" %}
To manage leave adjustments for a single employee, refer to this page: [Employee Pay Run View](https://help.allwage.com/modules/payroll/recurring-pay-runs/employee-pay-run-view.md#employee-leave-adjustment)
{% endhint %}

### Add Bulk Leave Adjustments

To get started, navigate to [Payroll > Pay Runs](https://help.allwage.com/modules/payroll/recurring-pay-runs/current-pay-run.md) and select the desired pay run.

<figure><img src="https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2Fr8CS57Ohw8zpNkoZMF7a%2Fbulk%20manage%20leave%20-%20payout.png?alt=media&amp;token=842c5230-c321-4936-bb43-d53c24e82d31" alt="" width="563"><figcaption><p>Add bulk leave adjustments</p></figcaption></figure>

1. **Select Employees**: Choose all or specific employees within the selected pay run.
2. Click on **Manage Leave**: Open the Manage Leave section.
3. Select the **Import Adjustment** Option: This will open the bulk management panel for leave adjustments.

<figure><img src="https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2FkQMT0TFKesOzPpQijDFW%2Fbulk%20leave%20adjustment.png?alt=media&amp;token=0bbd1ac4-47c1-466e-93b5-94bd1706313c" alt="" width="512"><figcaption><p>Select leave type and provide description</p></figcaption></figure>

4. Leave Adjustments can be applied to **any type of leave**: Select the leave that you want to adjust.
5. Provide a **Description** for the Leave Adjustment: Add a description that will be linked to all selected employees for transparency.

<figure><img src="https://4190935239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQs9GZ7QOfs5wHesuQLQh%2Fuploads%2FSU1PE8FATZQNdunZrwBv%2Fbulk%20leave%20adjustment%20values.png?alt=media&amp;token=2410e625-5f83-4c21-be70-a96500128f43" alt="" width="509"><figcaption><p>Provide leave adjustment values</p></figcaption></figure>

6. Adjustment **value**: The value provided here will be added to the existing leave balance. This value can be positive or negative.
7. **Balances**: The balance before and after the adjustment.
8. **Bulk Actions**
   * **Copy & Paste**: Copy values from one employee and use the paste option to apply them to other selected employees.
   * **Remove**: Remove specific employees from the bulk management list.
9. **Manage Templates**
   * **Download & Upload Template**: Download an Excel file to bulk edit or import values. Only employees in the current pay run will be included in the list. Any employees not found will be flagged as errors.
   * **Set Uniform Amount**: Use this quick action to apply the same amount to all employees in the list.

## Unpaid leave

Unpaid leave captured on the [Employee Overview](https://help.allwage.com/modules/time-and-attendance/reports/employee-overview.md) report only reduces pay through a pay run template that measures it, usually called **Unpaid Leave**. Whether you need that template depends on how the employee is paid.

| How the employee is paid                            | Days they don't work                                     | What to capture                                                                                     |
| --------------------------------------------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Hourly wage (paid for the hours they clock)         | Already unpaid: a day without clocks has no hours to pay | Nothing for pay. Do not add the **Unpaid Leave** template.                                          |
| Basic or fixed salary (a fixed amount each pay run) | Paid in full unless a template deducts them              | Unpaid leave on the Employee Overview, with the **Unpaid Leave** template on the employee's pay run |

### Hourly-wage employees

An hourly-wage employee is paid for the hours their earning templates measure from clocks. A day they don't clock has no hours, so they are not paid for it. If the employee also has the **Unpaid Leave** template, capturing unpaid leave for that day deducts it a second time. You can still capture unpaid leave to record why the employee was away, as long as the **Unpaid Leave** template is not on their pay run.

### Salaried employees

A basic or fixed salary is a fixed amount. Unpaid leave on the Employee Overview doesn't change it unless the **Unpaid Leave** template is on the employee's payslip. To add it:

1. Navigate to **Payroll > Pay runs** and click the pay run the employee is in.
2. Click the employee's name.
3. Click **Manage pay run templates**.
4. Under **Link recurring templates**, click **Add templates**.
5. Select **Unpaid Leave** and click **Add**.

The template now deducts the approved unpaid leave captured for the employee in this pay run and, because it is recurring, in later pay runs. Unapproved leave is not deducted. If there is no **Unpaid Leave** template in the list, [contact support](https://help.allwage.com/fundamentals/support-channels.md).

Absent days work the same way for salaried employees. A day is **Absent** when it is a required working day on the employee's clock template and the employee has no clocks, activities or leave on it. If the employee has a pay run template linked to **Absent days**, each absent day reduces their pay. A day with leave captured is never also absent, so the two templates don't deduct the same day twice. Employees whose clock template has [Ignore Absence](https://help.allwage.com/modules/time-and-attendance/configuration.md#ignore-absence) turned on are never absent.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.allwage.com/modules/payroll/leave.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
