Pay Groups
Payroll → Administration → Pay Setup → Pay Groups (/pay-setup) — who is paid together, over what period and on which date. Requires payroll:read / payroll:master.


Why pay groups exist
A pay group is the payroll population and its schedule. Employees in the same group share:
- Pay frequency — Monthly, Weekly, Biweekly, etc. (
PAYOUT_FREQUENCY_LABELS). - Calendar — period
startDate/endDateandpayDate. The calendar used to be a second tab; it is now inside the pay group so the population and its dates cannot drift. - Currency and employment-status scope.
The old separate Pay Calendars page no longer exists, and Pay Groups now lives on the Pay Setup page (/pay-setup). Update any bookmarks to the old /pay-groups and /calendars addresses.
The page
- Pay Setup has two tabs — Pay Groups (this page) and Salary Structures (
/pay-setup?tab=structures). - The Pay Groups table lists each group's Code, Name, Currency, Frequency (for example Monthly), Period (for example Ends last day), Pay Day (for example Last day), Proration basis (Calendar days, Working days or Fixed 30 — it decides whether week offs and holidays are paid when pay days are worked out from Payroll Attendance) and whether it is Active. Row actions are Edit and Delete.
- New Pay Group (top right) — name, code, frequency, period and pay-day rules, currency and proration. Saving validates that periods don't overlap illegally.
- Row actions: Edit, Delete (blocked if employees assigned).
- Bulk Assign Overlay (
/tabs/BulkPayGroupAssignOverlay) — select many payroll employees and move them to a group in one call. - Import / Export CSV — same pattern as other masters: template columns + example row overlay, stats
Rows / Created / Updated / Rejected, per-row failures.
:::tip Calendar is now part of the group If you followed older docs that said "create a Pay Group, then create a Pay Calendar", the second step is now inline: open the Pay Group and its calendar is the schedule section at the bottom of the form. There is no separate Pay Calendars page. :::