> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitaji360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Holiday Lists

> A holiday list records the public holidays and weekly off-days that apply to your employees.

A **holiday list** records the public holidays and weekly off-days that apply to your employees. It matters beyond the calendar: holidays and weekly offs determine how many *working* days a leave application actually consumes, and they feed into how payroll counts paid days. Get the holiday list right and your leave deductions and salary day-counts follow.

**You'll find this at:** `/hr/holidays` (the lists) and `/hr/holidays/:id` (a single list)

> Holiday lists belong to the active business — confirm the business switcher before creating or editing one. A list is then assigned to employees' contracts so the right holidays apply to the right people.

> 📷 *Screenshot: the Holiday Lists table showing name, country, year, weekly offs, and holiday count — to be added.*

***

## Creating a holiday list

On the Holiday Lists page choose **Create Holiday List**.

| Field                   | Required | Notes                                                                                                         |
| ----------------------- | -------- | ------------------------------------------------------------------------------------------------------------- |
| **Name**                | Yes      | E.g. *Uganda Public Holidays 2026*.                                                                           |
| **Country Code**        | Yes      | A 2-letter ISO code (e.g. `UG`). The form upper-cases it and refuses anything that isn't exactly two letters. |
| **Year**                | Yes      | A valid year between 1970 and 2100.                                                                           |
| **From Date / To Date** | Yes      | The window the list covers (defaults to the whole year). *From* must be on or before *To*.                    |
| **Weekly Off Days**     | No       | Comma-separated day names, e.g. `Saturday,Sunday`.                                                            |

***

## Inside a holiday list

Open a list to see its summary (country, year, weekly offs, holiday count) and two tabs:

* **Holidays** — the table of individual holiday dates.
* **Assignments** — which employees/contracts the list is assigned to.

> 📷 *Screenshot: a holiday list detail page with the Holidays table and the Add Holiday / Pull Regional Holidays actions — to be added.*

### Adding holidays

* **Add Holiday** — enter a **date** and a **description** (e.g. *Independence Day*) to add a single holiday.
* **Pull Regional Holidays** — imports the standard public holidays for the list's country automatically. Hitaji reports how many it imported and how many were skipped because they already existed.

Each holiday row shows its date, description, and a **type** badge — *Holiday* or *Weekly Off*. Remove a holiday with the bin icon on its row (you'll be asked to confirm).

### Deleting a list

The **Delete** button removes the entire list along with all its holidays and assignments. This is permanent, so you're asked to confirm.

***

## How holidays affect leave and payroll

* **Leave day counts** — holidays and weekly offs inside a leave application are normally not counted as leave taken, so an employee isn't charged for time the business was closed anyway. The exact treatment depends on the leave type: a type with **Include Holidays as LWP** counts holidays inside the application as unpaid leave, and an **Optional Leave** type may only be taken on dates flagged optional in the list. (These flags are set on the leave type — see [Leave types & settings](/hr/user/leave/leave-types).)
* **Half-days** — a half-day cannot be placed on a holiday.
* **Payroll** — payroll references the holiday list when working out paid days for a period, so the holidays you record here flow through to salary calculations.

***

## Permissions

| Action                                      | Permission        |
| ------------------------------------------- | ----------------- |
| View / create / edit / delete holiday lists | `hr-leave:config` |

***

## Related

* [Leave overview](/hr/user/leave/overview) — the wider leave model
* [Leave types & settings](/hr/user/leave/leave-types) — the flags that decide how holidays interact with each type
* [Applying for & approving leave](/hr/user/leave/leave-requests) — how day counts are computed
* [Leave calendar](/hr/user/leave/leave-calendar) — the team's time off