Skip to main content
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

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 (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 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 rather than here.

​
Permissions

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