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

# Payroll settings

> Payroll settings are the per-business switches that shape every run: how often you pay, in what currency, which statutory deductions apply and at what…

Payroll settings are the per-business switches that shape every run: how often you pay, in what currency, which statutory deductions apply and at what rates, and whether you provision gratuity. You set these once when you onboard a business's payroll, then revisit them only when policy changes (a new NSSF rate, switching gratuity on, etc.). Because these settings drive real calculations and real postings, only users with `payroll:config` can change them.

**You'll find this at:** `/payroll/settings` — which **redirects** to **Settings → ERP → Finance → Payroll settings** (`/settings/erp/finance/payroll-settings`).

> 📷 *Screenshot: the Payroll settings panel under Settings → ERP → Finance — to be added.*

> **Multi-business:** payroll settings belong to one business's accounting book. Confirm the business switcher; changing settings here affects only the business you are pointed at.

***

## The settings

| Setting                                 | Field                            | Notes                                                                                                                                                                                             |
| --------------------------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pay period**                          | `payPeriodType`                  | How often you pay: **Monthly**, **Bi-weekly**, or **Weekly**.                                                                                                                                     |
| **Pay day**                             | `payDay`                         | Day of the month payroll is processed (1–31).                                                                                                                                                     |
| **Country**                             | `country`                        | ISO country code (**UG / KE / TZ / RW / CUSTOM**). Governs which statutory brackets apply. Synced from your ERP/accounting general settings.                                                      |
| **Currency**                            | `currency`                       | 3-letter currency code (e.g. UGX). Synced with the country.                                                                                                                                       |
| **Enable PAYE**                         | `enablePAYE`                     | Switches income-tax (PAYE) computation on for runs.                                                                                                                                               |
| **Enable social security (NSSF/RSSB)**  | `enableNSSF`                     | Switches the social-security contribution on. The label reflects the country's scheme name (e.g. NSSF for Uganda).                                                                                |
| **Employee SS rate %**                  | `nssfEmployeeRate`               | The employee's contribution rate (0–100%). Editable only when social security is enabled.                                                                                                         |
| **Employer SS rate %**                  | `nssfEmployerRate`               | The employer's contribution rate (0–100%) — the business's additional cost on top of the employee deduction.                                                                                      |
| **Enable LST**                          | `enableLST`                      | Local Service Tax (Uganda). Hidden for countries that don't levy it.                                                                                                                              |
| **Accrue gratuity monthly**             | `gratuityAccrualEnabled`         | Opt this business into monthly gratuity provisioning. See [Gratuity](/hr/user/payroll/gratuity).                                                                                                  |
| **Months of gross per year of service** | `gratuityMonthsPerYearOfService` | The gratuity rate (0–12). Drives both monthly accrual and the separation payout. **Set to 0 if no gratuity is owed** — the toggle only governs the monthly accrual, not whether gratuity is paid. |

Each field saves on change (with a confirmation toast) rather than through one big Save button.

***

## What is *not* set here

* **PAYE tax bands** are not entered on this page — they live in [Income-tax slabs](/hr/user/payroll/income-tax-slabs) (and the platform-level statutory registry for your country). This page only switches PAYE on or off and selects the country.
* **Salary components, structures and periods** are configured on their own pages — see the [Payroll overview](/hr/user/payroll/overview) map. They sit alongside this page under **Settings → ERP → Finance**.
* **Statutory payable and payroll expense accounts** are resolved from your chart of accounts by their system codes (`paye_payable`, `nssf_payable`, `lst_payable`, the payroll expense and net-pay-payable accounts). If a run fails to post complaining about a missing system account, fix it in the [chart of accounts](/accounting/user/getting-started/chart-of-accounts) rather than here.

***

## Permissions

| Action                | Permission       |
| --------------------- | ---------------- |
| View payroll settings | `payroll:read`   |
| Change any setting    | `payroll:config` |

***

## Behind the scenes — what these settings drive

These settings don't post anything themselves — they govern what *runs* post:

* **Enable PAYE / NSSF / LST** decide which statutory deductions the statutory engine computes during a run, and therefore which payables are credited at approval and which [remittances](/hr/user/payroll/statutory-remittances) you build.
* **The NSSF rates** set how much employee and employer NSSF accrues. Forgetting the **employer** rate is a common cause of under-remitting.
* **The gratuity toggle and rate** drive the monthly gratuity accrual and the separation payout — see [Gratuity → Behind the scenes](/hr/user/payroll/gratuity).

***

## Related

* [Gratuity](/hr/user/payroll/gratuity) — the gratuity toggle and rate in depth
* [Statutory remittances](/hr/user/payroll/statutory-remittances) — what the PAYE/NSSF/LST switches feed
* [Income-tax slabs](/hr/user/payroll/income-tax-slabs) — the PAYE bands (configured separately)
* [Payroll overview](/hr/user/payroll/overview) — the whole chain and the settings map