← Guides
Integration How-Tos·9 min read

Xero Payroll setup for small businesses in South Africa

Xero Payroll is available in South Africa and handles the basics well — PAYE calculations, UIF deductions, payslip generation, and the journal entries that flow through to your accounts automatically. For a small business with a straightforward payroll, it removes the need for a separate payroll tool. For anything more complex, you'll hit its limits.

Enabling Xero Payroll in South Africa

Xero Payroll is a separate add-on — it's not included by default in your Xero subscription. You enable it from Settings > Payroll Settings in your Xero organisation. Xero will prompt you to confirm your country is South Africa, which activates the SA-specific tax tables and statutory calculations.

Once enabled, the Payroll menu appears in your Xero navigation. From there, you configure your organisation's payroll details before processing any employees.

Organisation-level payroll setup

Before adding employees, you need to configure:

PAYE reference number — your employer PAYE number from SARS. This links your payroll records to your EMP201 submissions. If you don't have one, you'll need to register with SARS as an employer before processing payroll.

UIF reference number — your employer UIF registration number from the Department of Employment and Labour. Required for UIF calculations and declarations.

Pay periods — set whether you pay weekly, fortnightly, or monthly. This affects how Xero calculates PAYE using the correct tax tables.

Bank account — the account payroll payments are processed from.

Chart of accounts mapping — Xero will map payroll journals to your accounts automatically. Review this mapping to make sure payroll expenses, PAYE liability, and UIF liability post to the correct accounts.

Adding employees and configuring tax

Each employee record needs:

  • ID number or passport number
  • Tax number (if available — Xero can process without it but IRP5s will be incomplete)
  • Employment type (permanent, fixed-term)
  • Salary or hourly rate
  • Tax directive or tax status — this drives PAYE calculation. Most employees are "Tax directive: standard" unless they have a fixed directive from SARS

PAYE calculation

Xero uses the current SARS tax tables for PAYE withholding. It applies the correct rebates (primary, secondary, tertiary) based on the employee's age. For employees with multiple employers or additional income, a SARS tax directive is the correct approach — standard tax table calculations won't account for the full picture.

Xero recalculates PAYE each pay period on a year-to-date basis, which means early-year underpayments or overpayments are corrected across the rest of the tax year. This is consistent with how SARS expects PAYE to work.

UIF deductions

Xero calculates UIF at 1% from the employee and 1% from the employer, applied to the UIF earnings ceiling (updated annually by the Department of Employment and Labour). Earnings above the ceiling don't attract UIF. Xero handles this automatically once the employee's salary is entered correctly.

Employees who are exempt from UIF — directors of private companies in some circumstances, foreign nationals on certain visa types — need to be flagged manually in their employee record.

Processing a pay run

The pay run workflow in Xero is:

  1. Start a pay run — select the pay period. Xero pulls in all active employees.
  2. Review and edit — Xero pre-fills salary, PAYE, and UIF for each employee. Add any once-off items: commissions, bonuses, overtime, expense reimbursements, deductions.
  3. Approve the pay run — once approved, Xero posts the payroll journals to your accounts and marks the period as processed.
  4. Generate payslips — Xero generates a payslip for each employee. These can be emailed directly from Xero or downloaded as PDFs.
  5. Process payments — Xero doesn't initiate bank payments; it produces a payment file or report for you to upload to your bank's internet banking platform.

What Xero Payroll doesn't do

It won't file EMP201 for you. SARS EMP201 is the monthly return for PAYE, SDL, and UIF. Xero gives you the figures; you submit EMP201 on eFiling manually.

It won't submit UIF declarations to uFiling. UIF monthly declarations still need to be processed through uFiling separately. Xero gives you the data.

SDL is not calculated. Skills Development Levy (SDL) calculation is not handled natively by Xero Payroll SA. If your payroll exceeds the SDL threshold, you'll need to track this outside of Xero or through a dedicated payroll tool.

IRP5s require careful review. Xero generates IRP5 data at year end, but the reconciliation between payroll totals, EMP501 submissions, and SARS records needs to be done carefully. Complex scenarios — mid-year employment, multiple employers, tax directives — increase the chance of discrepancies that require manual correction.

No leave management system. Xero tracks leave balances but it's basic. Approval workflows, leave calendars, and multi-leave-type management are outside its scope.

Xero Payroll vs dedicated payroll tools

FeatureXero PayrollPaySpaceSage Payroll
PAYE and UIFYesYesYes
SDL calculationNoYesYes
EMP201 submissionManualAssisted/directAssisted/direct
UIF uFiling integrationNoYesYes
IRP5/EMP501 generationBasicFullFull
Leave managementBasicFullFull
Employee self-service portalNoYesYes
Integration with Xero accountingNativeVia integrationVia integration
CostIncluded with Xero add-onFrom ~R125/employee/monthVaries

PaySpace and Sage Payroll are built specifically for SA compliance complexity. They handle SDL, maintain current regulatory updates, provide direct uFiling integration, and offer proper IRP5 and EMP501 processing. They're meaningfully better tools for payroll. The tradeoff is a separate cost and a separate system to maintain — meaning your payroll data doesn't flow into Xero automatically without a data integration.

When Xero Payroll makes sense

Use Xero Payroll if:

  • You have a small headcount (under 15–20 employees works well)
  • Payroll is straightforward — fixed salaries, no complex commission structures, standard tax status
  • You're below the SDL threshold (currently R500,000 annual payroll)
  • Keeping accounting and payroll in one place is worth more to you than the additional compliance features of a dedicated tool
  • Your accountant or bookkeeper works primarily in Xero

When to integrate a dedicated payroll tool instead

Consider PaySpace, Sage Payroll, or a similar dedicated tool if:

  • You have SDL liability and want it calculated and tracked properly
  • Your team uses a leave management portal and employee self-service
  • You want direct EFT or bank file generation from payroll
  • You have complex payroll — commissions, variable hours, multiple pay rates
  • You want proper EMP501/IRP5 processing at year end without manual reconciliation

Connecting a dedicated payroll tool to Xero is achievable — payroll journals can be exported and imported, or a custom integration can post payroll summaries to Xero accounts automatically. It adds a step, but the data ends up in the right place either way.

If you're running Xero and want your payroll connected cleanly to your accounting stack — whether that's through Xero Payroll or an integrated dedicated tool — the systems integration service covers this kind of work.


Some links in this guide are affiliate links. If you sign up through them, Gainly may earn a commission — at no cost to you. We only recommend tools we'd recommend regardless.

Need your payroll connected to the rest of your accounting stack?

Describe what you're working with and I'll come back with something specific — not a sales call.

Tell me what you're dealing with