UK Workplace Pensions in QuickBooks Online Payroll: Setup Steps and Snags
Plan gating, a provider reference that must match exactly and a six-week letter deadline: where UK pension setup stalls, and what resolves it.
Workplace pension setup is the part of UK payroll where QuickBooks Online users most often stall. The screens themselves are simple once you know the order to work through. The trouble sits around them. A Smart pensions feature is gated to the two higher plans. A provider reference has to match character for character. And the statutory deadlines are recorded by the software but not chased for you. We walked the path that works, and flagged the points where it bites.
The information to gather first
Two items decide whether setup takes minutes or an afternoon: the pension provider’s name and reference number, and the employer and employee contribution amounts. Neither can be worked out inside QuickBooks. The software stores and applies both; it does not choose them for you.
Which plans can run Smart pensions?
Smart pensions appear only on Payroll Premium and Payroll Elite. If you are on Core and the option is nowhere to be found, that absence is by design, not a fault to be troubleshot. To confirm what you are on, sign in, open Settings, and choose Subscriptions and billing. The payroll plan name sits in the second box. Plenty of stalled setups trace back to this one check.
The setup path that works
Five steps, in this order.
Start with the pension start date. Select the gear icon, open Payroll settings, and use the pencil beside Workplace pensions. A calendar field takes the date, and if your duties have already begun without a fixed date, a tick box covers that. The same screen holds an optional re-enrolment date, which matters at your third anniversary. Save, then Done.
Second, build the scheme. Beside Pension schemes, pick the pencil and choose Add a company pension. Your provider should appear in the dropdown; if not, select Other.
The pension name you type here is what employees will see on their payslip next to the pension amount, so name it plainly. The provider reference number goes in beside it, and an optional group name lets large employers split staff into categories. To auto enrol, switch on earnings thresholds so the latest defined figures apply, then choose the taxation method that matches your provider’s arrangement.
Third, set pension pay types. Under Pay types in Payroll settings, the Pension pay types screen decides which earnings count towards the calculation. Bonus and overtime are the usual toggles. The provider’s definition of pensionable pay governs here, and a wrong choice shows up later as contributions computed on the wrong base.
Fourth and fifth cover people rather than screens. Employees must be told about their enrolment, and then enrolled. The enrolment runs from the Employees list under Payroll: open the person, use the pencil beside Workplace pension, loan and other deductions, and pick Set up workplace pension. You will choose the worker category, the applicable setting, the scheme, and both contribution amounts.
Why does the provider reference fail?
The recurring culprit is Smart Pension. The reference number field in scheme setup is not free-form for this provider: it must reproduce the Company ID shown in your Smart Pension dashboard, exactly. A reference copied from old paperwork will not do, and the mismatch tends to surface downstream rather than at the point of entry. Copying the identifier straight from the provider’s dashboard resolves it.
The six-week letter runs from your duties start date
Employees must be informed about their enrolment within six weeks of your duties start date, the date your obligations as an employer began. It is not six weeks from the day you finished configuring the scheme, and treating it that way is how the deadline slips. Some providers send this correspondence on the employer’s behalf. If yours does not, The Pensions Regulator publishes a letter template that can be adapted.
How does an employee opt out?
Opting out is a statutory right, and it runs through the pension provider, not through payroll. The employee obtains and completes the provider’s opt-out form, and the provider confirms the notice. Anyone who opts out within a month of being enrolled receives a refund of the contributions taken. Later than that, they can still leave the scheme, but the money stays invested until they choose otherwise.
Two employer rules matter as much as the mechanics. Enrol first, and act only on the provider’s confirmed notice. And nothing in your communications may nudge a person towards opting out.
The declaration of compliance is a separate job
Setting up the scheme in QuickBooks does not file your declaration of compliance with The Pensions Regulator. That submission tells the regulator which scheme you used and how many staff were enrolled, and it is due within five months of your duties start date. Nothing in the payroll software prompts it. This is the obligation most likely to fall through the gap once contributions are flowing and payslips look right.
Re-enrolment comes back every three years
Automatic enrolment is not a one-off. Every three years, staff who previously opted out must be reassessed and re-enrolled on your re-enrolment date, and the field you saw in step one exists for exactly that. Choose the date with the third anniversary of your duties start date in mind, and let the automatic re-enrolment setting do the remembering.
The pattern in the accepted guidance is consistent. QuickBooks Online Payroll handles the calculations and the payslips reliably once the scheme is configured with the right reference, the right pay types, and the right dates. Most reported failures trace back to something outside the software: a plan without the feature, a mismatched identifier, or a deadline nobody wrote in the diary.