> 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/payrun-templates/public-holidays.md).

# Public Holidays

Public holiday pay rules (BCEA): double pay, Sundays, shifts over midnight, public holiday hours metrics, linking them to pay run templates, and swapping or suppressing a public holiday.

Public holidays affect both time and attendance calculations and payroll. This page covers the legal rules, how AllWage handles public holidays automatically, the metrics you should review, and how to swap or suppress a public holiday when needed.

## Legal Framework

The **Basic Conditions of Employment Act (BCEA), Section 18** governs how employees must be paid on public holidays. The **Public Holidays Act** governs which days are public holidays and allows employers and employees to agree to exchange a public holiday for another day.

{% hint style="info" %}
An employer may not require an employee to work on a public holiday except in accordance with an agreement.
{% endhint %}

{% hint style="warning" %}
This page explains how AllWage reads these rules and how to set them up. It is not legal advice. Your employees' contracts and any bargaining council agreement come first: check them, and ask your labour advisor if you are unsure.
{% endhint %}

## Public Holidays on Regular Working Days

A regular working day is a day that the employee is normally scheduled to work. For most operations this is Monday to Friday, but many industries — particularly retail, hospitality, and continuous operations — include Saturdays and even Sundays as regular working days. What matters is what the employee's schedule defines as a normal working day, not what the calendar says.

If a public holiday falls on a regular working day:

* **Employee does not work** — They must still be paid at least their normal daily wage. The holiday does not reduce their pay.
* **Employee works** — They must be paid at least **double** their normal daily wage.
* **Employee works overtime** — AllWage advises paying hours above the budget hours at double the rate. The Act does not name a rate for these hours; double is the safe reading, because the day itself is paid double.

**Example:** A public holiday falls on a Wednesday. The employee's normal shift is 8 hours.

* Employee doesn't work: Paid 8 hours at normal rate
* Employee works 8 hours: Paid 8 hours at normal rate **plus** 8 hours at normal rate = 16 hours total (double pay)
* Employee works 10 hours: Paid 16 hours (double for the regular 8) **plus** 2 hours overtime at double rate

## Public Holidays on Optional Working Days

An optional working day is a day the employee would not normally work — typically a Saturday for Monday-to-Friday employees. In AllWage, these are configured as part of the [clock template](https://help.allwage.com/modules/time-and-attendance/configuration.md#clock-templates) when certain days are marked as optional.

If a public holiday falls on an optional working day:

* **Employee does not work** — No payment is required. Since they would not have worked that day anyway, the public holiday does not create an obligation.
* **Employee works** — AllWage advises paying **double the rate** for all hours worked, the same as a Sunday. The Act speaks of an ordinary daily wage plus the pay for the work, but a day the employee does not ordinarily work has no set daily wage.

**Example:** A public holiday falls on a Saturday. Saturday is an optional working day for the team.

* Employee doesn't work: No pay for that day
* Employee works 6 hours: Paid 6 hours at double rate = 12 hours equivalent

## Public Holidays That Fall on a Sunday

When a public holiday falls on a Sunday, the following Monday is also declared a public holiday. Both the Sunday and the Monday are separate public holidays — the Monday is not a replacement for the Sunday.

For operations where Sunday is a regular or optional working day:

* An employee who works on the **Sunday** must be compensated under the normal public holiday rules for that day
* An employee who works on the **Monday** must also be compensated — it is its own public holiday
* An employee who works **both days** has worked two public holidays and must be compensated for each one separately

**Example:** Freedom Day (27 April) falls on a Sunday. Monday 28 April is declared a public holiday.

* A hospitality employee works both days — each day is treated as a separate public holiday with its own pay entitlement
* An office employee who only works Monday to Friday is not affected by the Sunday holiday but must be paid for the Monday public holiday as normal

## Shifts That Span Midnight

When a shift crosses midnight into or out of a public holiday, AllWage counts the whole shift on the day it started:

* A shift that **starts on a normal day** and runs past midnight into a public holiday is a normal day's shift. None of its hours are public holiday hours.
* A shift that **starts on a public holiday** is a public holiday shift, including the hours worked after midnight.

**Example:** An employee works a night shift from 18:00 on Tuesday to 02:00 on Wednesday. Wednesday is a public holiday. AllWage treats the whole shift as a normal Tuesday shift.

{% hint style="warning" %}
**The BCEA uses a different rule.** Section 18(5) looks at where the greater portion of the shift was worked: the whole shift counts on the public holiday unless the greater portion was worked on the other day. AllWage does not apply this rule. For a shift where the two give a different answer, for example a shift from 22:00 on Tuesday to 06:00 on a public holiday Wednesday, change the day by hand with the public holiday override: see [Exchanging a Public Holiday for Another Day](#exchanging-a-public-holiday-for-another-day). This is not legal advice.
{% endhint %}

See [Which day a shift belongs to](https://help.allwage.com/modules/time-and-attendance/how-hours-are-calculated.md#which-day-a-shift-belongs-to).

## How AllWage Handles Public Holidays Automatically

AllWage knows all South African public holidays. When a public holiday falls on a day that is a required working day for an employee, the system automatically:

* **Prevents the employee from being marked as absent.** Employees cannot be absent on a public holiday.
* **Displays the public holiday name** in the employee's cell on the [Employee Overview Report](https://help.allwage.com/modules/time-and-attendance/reports/employee-overview.md), under the column for that specific day.
* **Shows the required working hours** next to the public holiday name. This indicates the hours the employee is entitled to be paid if they do not come to work.
* **Lists actual clocked hours separately** in the same cell if the employee does work on that day.

No configuration is needed. As long as the employee has a clock template assigned with the correct working days, the system handles it.

## Time & Attendance Metrics

When employees work on a public holiday, AllWage calculates the following metrics visible on the [Employee Overview Report](https://help.allwage.com/modules/time-and-attendance/reports/employee-overview.md):

### Public Holiday Budget Hours (Required Days)

The hours the employee was required to work if the public holiday falls on a required working day. This is what the employee is entitled to be paid regardless of whether they come to work.

### Public Holiday Clocked Hours

The actual hours worked on the public holiday, broken into three metrics:

* **Normal Hours** — Hours worked up to and including the budget hours for that day
* **Overtime** — All hours worked beyond the budget hours. AllWage advises paying these at double the rate
* **Total Hours** — Normal hours plus overtime combined

### Public Holiday Optional Hours

All hours worked on a public holiday that falls on an optional working day. This includes both normal and overtime hours in a single metric, because AllWage advises paying all hours worked on an optional public holiday at double the rate.

### Example: Public Holiday on a Required Working Day

Thursday is a required working day. The employee is required to work 9 hours. Thursday is a public holiday. The employee comes to work and clocks 10 hours.

* **Public Holiday Budget Hours:** 9 — The hours they are required to work, paid regardless of attendance
* **Public Holiday Clocked Normal:** 9 — Hours worked up to the budget
* **Public Holiday Clocked Overtime:** 1 — Hours worked beyond the budget
* **Public Holiday Clocked Total:** 10 — Normal + overtime
* **Public Holiday Optional Hours:** 0 — Not an optional day

To calculate the correct pay: the employee must be compensated for the 9 budget hours, plus 9 normal hours worked, plus 1 overtime hour at double the rate. That is effectively 20 hours of pay for that day.

### Example: Public Holiday on an Optional Working Day

Saturday is an optional working day. The employee is not required to work. Saturday is a public holiday. The employee comes in and works 6 hours.

* **Public Holiday Budget Hours:** 0 — This metric only counts public holidays on required working days
* **Public Holiday Clocked Normal:** 0 — Not applicable for optional days
* **Public Holiday Clocked Overtime:** 0 — Not applicable for optional days
* **Public Holiday Clocked Total:** 0 — Not applicable for optional days
* **Public Holiday Optional Hours:** 6 — All hours on an optional public holiday

To calculate the correct pay: the 6 optional hours must all be compensated at double the rate — effectively 12 hours of pay.

{% hint style="warning" %}
**These hours need their own pay run template.** None of the other public holiday metrics count hours worked on a public holiday that falls on an optional day. If no pay run template is linked to **Public Holiday Optional Hours**, those hours are not paid.
{% endhint %}

### Exporting Public Holiday Data

If you do not use AllWage payroll, use the **Time & Attendance metrics export** and select the relevant public holiday metrics for the period. This exports all values in Excel format for processing in your external payroll system.

## Payroll Configuration

When configuring public holiday pay in your payroll templates, ensure that all four metric categories are included:

* **Budget Hours** — So employees are paid for the public holiday regardless of whether they work
* **Clocked Normal Hours** — The additional compensation for hours worked on the public holiday
* **Clocked Overtime** — At double the rate, as AllWage advises. If overtime hours are already included in another metric, add overtime at a rate of 1 so that it totals double
* **Optional Hours** — Linked at double the rate for all hours clocked on an optional public holiday, as AllWage advises

These are AllWage's readings of section 18 of the BCEA, not legal advice. Your contracts may set something different. For the reasons behind them, and for what this setup pays on a shift shorter than the budget hours, see [How AllWage reads section 18](https://help.allwage.com/modules/time-and-attendance/custom-metrics/custom-metric-sets.md#a-set-for-daily-overtime-monday-to-friday).

{% hint style="info" %}
To link these metrics to a template, click **+** next to **Link a metric or quantity (Optional)**, choose **Working hours** and set the **Working hours type** to **Public Holidays**. See [Link a metric or quantity](https://help.allwage.com/modules/payroll/payrun-templates.md#link-a-metric-or-quantity).
{% endhint %}

## Exchanging a Public Holiday for Another Day

The **Public Holidays Act** permits an employer and employee to agree to exchange a public holiday for another day. This is common when a public holiday falls in the middle of the week and the employer prefers to move it to a Monday or Friday.

{% hint style="warning" %}
The exchange must be **by agreement** between the employer and the employee.
{% endhint %}

### How to Swap a Public Holiday in AllWage

AllWage provides a **public holiday override**: the **Public Holiday** field of the hours override on the [Employee Overview](https://help.allwage.com/modules/time-and-attendance/reports/employee-overview.md) report. Because overrides are applied at the employee level, you can swap a holiday for one team without affecting the rest of the company.

* **For one employee:** click the employee's day on the Employee Overview to open the [employee timeline](https://help.allwage.com/modules/time-and-attendance/reports/employee-overview.md#employee-timeline), click **Add override** and choose **Add hours override**. The timeline does not offer **Add override** on a day that shows **Missing Template**, where no shift applies to the employee. If the day already has an hours override, the dialog opens it, and its button reads **Update override** instead of **Add override**.
* **For several employees:** click the cogwheel next to the date on the Employee Overview and select **Add override for all employees**. The override is added for every employee in the generated report, including employees hidden by the report's search box or the **Exceptions** filter. The panel's title shows how many employees it will change. To limit it to some employees, generate the report for only the **Teams** or **Employees** you want first.

Watch our video here:

{% embed url="<https://youtu.be/o_7pE8UHo30>" %}
Swap Public Holidays
{% endembed %}

The override has three options:

* **Default** — No override. The system checks the public holiday calendar as usual.
* **Public Holiday** — The day is treated as a public holiday, regardless of the calendar. A description is required (e.g., "Youth Day — swapped from 16 June").
* **Normal Day** — Any public holiday on that day is suppressed. The day is treated as a normal working day.

### Swapping a Public Holiday

**Example:** Youth Day (16 June) falls on a Wednesday. The employer and employees agree to observe the holiday on Friday 18 June instead.

**Step 1 — Suppress the original public holiday:**

1. On the Employee Overview, open the employee's timeline for **16 June**, click **Add override** and choose **Add hours override**
2. Set the **Public Holiday** dropdown to **Normal Day** and click **Add override**
3. The employee is now expected to clock in on 16 June as usual

**Step 2 — Add the public holiday to the new day:**

1. Open the employee's timeline for **18 June**, click **Add override** and choose **Add hours override**
2. Set the **Public Holiday** dropdown to **Public Holiday**
3. Enter a description: "Youth Day — swapped from 16 June"
4. Click **Add override**. The employee will not be marked absent on 18 June, and all public holiday pay rules apply to this day

**Step 3 — Apply to all affected employees:**

At the top of the Employee Overview Report, each date column has a **cogwheel icon**. Click it and select **Add override for all employees** to apply the override to every employee in the generated report, including employees hidden by the report's search box or the **Exceptions** filter. The panel's title shows how many employees it will change. If you only need to override a subset of employees, generate the report for only those **Teams** or **Employees** first, then use the bulk option.

No changes to pay run templates or input templates are needed. The system automatically adjusts — public holiday metrics will appear on the new day, and the original day will be treated as a normal working day.

### Suppressing a Public Holiday Without a Swap

If the employer requires employees to work on a public holiday and has agreed with employees that the day will be treated as a normal working day:

1. On the Employee Overview, open the employee's timeline for the public holiday date, click **Add override** and choose **Add hours override**
2. Set the **Public Holiday** dropdown to **Normal Day** and click **Add override**
3. The day is treated as a normal working day: the employee is expected to clock in, normal absence rules apply, and no public holiday metrics are generated

To apply in bulk, click the cogwheel on the date column in the Employee Overview Report and select **Add override for all employees**.

### What the Override Changes

When you set an override, the system adjusts everything downstream automatically:

* **Employee Overview Report** — The public holiday name and metrics appear on the overridden day, not the calendar day
* **Absence detection** — The employee is not marked absent on the day marked as a public holiday, and normal absence rules apply on the day marked as a normal day
* **Leave calculations** — Leave is not deducted on a day marked as a public holiday
* **Pay run templates** — Public holiday input templates fire on the overridden day, not the calendar day
* **Payslip** — The public holiday description you entered appears on the payslip for the overridden day

{% hint style="warning" %}
**Both steps are needed for a swap.** If you only suppress the original day but don't add the holiday to the new day, the employee loses the public holiday entirely. If you only add the new day but don't suppress the original, the employee gets two public holidays.
{% endhint %}


---

# 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/payrun-templates/public-holidays.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.
