No articles found for “”.
Salary components: structuring gross pay
By default, every employee's gross pay is split three fixed ways, Basic, Housing, and Transport. Salary components let you structure that gross your own way instead: keep the three standard parts, rename or add your own (for example a fixed Meal or Leave component), and have each one show on the payslip. Gross monthly stays the total you type; the components split it, and anything you don't allocate is treated as "Other (taxable)".
Turning this on never changes anyone's take-home or tax. Before it enables, SpireSlip runs your payroll both ways and only proceeds if every figure, gross, PAYE, pension, NHF, and net pay, comes out exactly the same. If a single amount would move, nothing is enabled and SpireSlip tells you which employee to look at.
Do you need this?
You can safely skip this feature if:
- You enter a single gross figure per employee, this already works on its own. The Basic, Housing, and Transport split is optional; leave it blank and the whole gross is treated as Basic.
- The standard Basic, Housing, Transport split already fits how you pay.
Turn it on when:
- You pay named parts of salary that your staff expect to see itemised on the payslip.
- You want a part of salary that is taxed but sits outside the pension base.
Salary components vs. allowances and deductions
Salary components make up the gross, they slice the same gross figure into named parts. They are different from custom payroll components (allowances and deductions), which are amounts added on top of, or taken off, pay, and which support calculation methods and effective dates. If you want to add a cooperative deduction or a percentage allowance, use that feature instead. If you want to decide what the gross is made of, you are in the right place.
Adding your own components
Every entity already has three standing components: Basic, Housing and Transport. There is nothing to switch on to use them. The Manage components page is where you add extra components (for example a hazard or meal allowance) on top of those three.
- Go to Entities, choose the entity, then open its Payroll tab and the Advanced sub-tab, and click Manage salary components.
- You will see Basic, Housing and Transport listed as this entity's standing components.
- To add your own, fill in Add a component (a name and its tax treatment) and click Add.
- The first time you add a component, SpireSlip itemises your existing employees' Basic, Housing and Transport into individual components automatically, with no change to anyone's pay or tax. It asks you to confirm before doing this.
- If SpireSlip cannot safely itemise someone, it names them and why (almost always: their Basic, Housing, and Transport do not add up to their gross). Nothing is changed: correct that person's figures in Employees, then add your component again.
Salary components are available on every plan, including Core.
For your accountant: the safety check
When you enable, SpireSlip computes the entire payroll twice, once on the current fixed split and once as components, and compares every statutory output for every employee to the kobo: gross, PAYE, both pension legs, NHF, NHIS, rent relief, taxable income, NSITF, WHT, and net pay. It commits the change only if all of them match exactly. If any figure would differ, it enables nothing and reports the affected employee. Enabling is therefore a zero-change switch for the numbers as they stand today.
The two tax treatments
Every component you create is one of two treatments. There is no non-taxable option: SpireSlip treats every cash part of salary as taxable. If you think a payment should not be taxed, ask your accountant.
- Taxable + Pensionable, the same treatment as Basic, Housing, and Transport. The amount is taxed and it counts toward the pension base.
- Taxable only, the amount is taxed for PAYE but sits outside the pension base, so it raises tax but not pension.
Exactly one component is marked the NHF base. NHF is 2.5% of that component (normally Basic).
For your accountant: the statutory basis
Pensionable pay is Basic + Housing + Transport, the monthly emoluments defined by the Pension Reform Act 2014, so a Taxable + Pensionable component is added to that base and contributions are 8% employee / 10% employer of the total. A Taxable only component is part of taxable income for PAYE under the Personal Income Tax Act as amended by the Nigeria Tax Act 2025, but is excluded from the pension base. NHF is 2.5% of the NHF-base component. If enabling would change any of these for any employee, the safety check blocks it.
Setting component amounts per employee
Open an employee (Add or Edit) and, in the salary section, type the Gross monthly you intend to pay. Then split as much of it as you like into the named components. You do not have to fill every naira into a component: anything you leave unallocated is treated automatically as "Other (taxable)", so the components always add up to Gross without you having to balance them by hand. (If your named components add up to more than Gross, the form asks you to reduce them or raise Gross.) Use the Manage components link on that screen, or the entity's Payroll → Advanced → Salary components, to add the component types themselves.
Component amounts take effect from the next payroll run you compute. If you need an allowance or deduction that starts on a specific date, or that is a percentage rather than a fixed part of gross, use custom payroll components instead, which support effective dates and calculation methods.
Turning it back off
Switching an entity back to the standard fixed split is not yet self-service. If you need to turn salary components off for an entity, contact support and we will do it for you.