Enable permissions for Zenoti Integrated Payroll
Three permissions gate access to Zenoti Integrated Payroll (ZIP). This article walks through which permission unlocks which capability, the path to grant any of them, and the meta-permission required to make permission changes — answering the "who configures the configurator" question up front.
Audience: Administrators who configure user roles in Zenoti. The user receiving the permission can be any role; the user granting it needs the Manage Security Roles meta-permission described below.
On this page
- Before you begin
- The complete ZIP permission set
- Who configures the configurator: the meta-permission
- Steps: grant a ZIP permission to a role
- Verify the permission took effect
- Common mistakes
- Frequently asked questions
- Related articles
Before you begin
- Your user must have the
Manage Security Rolespermission under Configuration > Security to edit any Security Role. If you do not have this permission, the role you want to edit will appear read-only or not appear at all. Ask your Zenoti administrator to grant it. - The role you are editing must already exist. If the role you want to grant payroll permissions to does not exist yet, create it first under Configuration > Security > Security roles.
- The user receiving the permission must be assigned to the role you are editing. Permission grants apply to roles, not directly to users.
The complete ZIP permission set
ZIP exposes three permissions: Configure Payroll Payouts and Process Payroll Payouts are actions on the Payments object under Administrator, and Access Payroll Payouts Reports is a reports permission (the Employee reports group). There are no hidden ZIP permissions; the list below is exhaustive. If you grant all three to a role, that role has full ZIP access. Most roles need only one or two.
| Permission | Unlocks | Use for |
|---|---|---|
| Configure Payroll Payouts | Business onboarding, employee onboarding, bank-account setup, tax setup, document access, TPA configuration, pay-day settings | Payroll administrators who configure the system but may not run payroll cycles |
| Process Payroll Payouts | Initiate, preview, submit, reopen regular and off-cycle payroll cycles | Users who actually run payroll each cycle |
| Access Payroll Payouts Reports | View and export the Payroll Journal Report and the Payroll Register Report | Auditors, finance team, anyone who needs reporting but should not run payroll |
Two additional permissions affect the Documents area of the dashboard but are not ZIP-exclusive:
| Permission | Unlocks | Use for |
|---|---|---|
| Manage Documents (an action on the Payments object under Administrator) | Upload, organize, share documents | Anyone responsible for document management |
| View Documents (an action on the Payments object under Administrator) | Read-only access to shared documents | Auditors, employees needing to retrieve their own historical documents |
If your business uses leave management (PTO), separate Leave Management permissions also apply — see Configure role permissions for leave management.
Who configures the configurator: the meta-permission
A common question: who can grant ZIP permissions to others? The answer is the user who holds Manage Security Roles under Configuration > Security.
Two important properties of this meta-permission:
- It is independent of the ZIP permission set. A user can grant
Process Payroll Payoutsto others without holdingProcess Payroll Payoutsthemselves. Granting a permission does not require holding it. - It is typically held by Organization-level administrators (the role originally set up when the Zenoti tenant was created) and by users that role has explicitly granted it to.
If no one in your organization currently holds Manage Security Roles, contact support@zenoti.com with your business name and FEIN; Zenoti can re-establish the meta-permission on the original administrator role.
Steps: grant a ZIP permission to a role
- Sign in to Zenoti as a user with
Manage Security Roles. - Go to Configuration > Security > Security roles.
- Find the role you want to grant the permission to. If you know the role name, use the role list to locate it directly.
- Open the role for editing.
- Navigate to the Administrator tab, then the Payments sub-section.
- Locate the three ZIP permissions (Configure Payroll Payouts, Process Payroll Payouts, Access Payroll Payouts Reports) and select the checkbox next to each one you want to grant.
- Save the role.
Users assigned to the edited role will have the new permissions on their next sign-in. Already-signed-in users may need to refresh the page or sign out and back in.
Note: ZIP also requires the
enable_payroll_payoutsfeature flag to be active for your organization. The feature flag is independent of role permissions; if it is off, no role can access ZIP regardless of permissions. To verify or enable it, contactsupport@zenoti.com.
Verify the permission took effect
After granting a permission and the user signs in:
- Have the user navigate to Employee > Zenoti Integrated Payroll. The menu item should appear.
- The dashboard should load. The sections visible depend on which permission you granted:
Configure Payroll Payoutsshows Employees, Documents, Company Transactions, Benefit Partners, Settings.Process Payroll Payoutsshows Payrolls (with run / submit / reopen actions).Access Payroll Payouts Reportsshows Reports.
- If the menu item still does not appear, confirm the user is assigned to the edited role (
Configuration > Employee > {employee} > Role) and that theenable_payroll_payoutsfeature flag is on.
Tips
- Grant the minimum permission each role needs. A finance auditor pulling reports needs only
Access Payroll Payouts Reports; do not grant the full set as a default. - Check that the
enable_payroll_payoutsfeature flag is on before granting permissions — granting permissions while the flag is off works, but users won't see the menu until the flag is enabled. - Keep the path in mind:
Configuration > Security > Security roles > {role} > Permissions > Administrator > Payments. Do not look for the payroll or document permissions under any other Administrator object; Access Payroll Payouts Reports is granted with the reports permissions instead. - Use a single role for "Payroll Manager" rather than granting permissions to many one-off roles. Centralizing the permission grant simplifies audits.
- Test changes by signing in as a user assigned to the modified role. Permissions apply on next sign-in.
Troubleshooting
Quick reference for permission-grant problems:
- Role list is read-only or empty. Your user lacks
Manage Security Roles. - User has the permission but menu is missing. Sign out and back in; check the feature flag.
- Permission granted but expected functionality not visible. Confirm the permission unlocks the specific section the user is looking for.
- Setup Documents not visible despite Document permission. Setup Documents requires
Configure Payroll Payouts. - Multiple users on the same role still don't see the menu. Confirm role assignment scope (organization vs specific centers).
| Problem | Resolution |
|---|---|
| The role list is read-only or empty | Your user lacks Manage Security Roles. Have an Organization-level administrator grant it, or contact support@zenoti.com if no one in the org currently holds the meta-permission. |
| User has the permission but Employee > Zenoti Integrated Payroll still doesn't appear | Have the user sign out and back in. If still missing, confirm the enable_payroll_payouts feature flag is on (contact support@zenoti.com to verify). |
User has Configure Payroll Payouts but cannot run payroll |
Configure-only permission unlocks setup; running payroll requires Process Payroll Payouts. Add it. |
| User has the permission but cannot download Setup Documents | Setup Documents requires Configure Payroll Payouts in addition to any Document permission. |
| Granted permission to a role but multiple users on that role still don't see the menu | Confirm those users are actually assigned to the edited role at the right scope (organization or specific centers). Permission grants follow role assignment. |
Common mistakes
- Granting
Configure Payroll Payoutsonly and expecting the user to run payroll. That permission unlocks setup, not payroll-cycle execution. AddProcess Payroll Payoutsfor the user who actually runs payroll. - Granting
Manage Documentsonly and expecting access to setup documents. The Setup Documents sub-section requiresConfigure Payroll Payoutsin addition to Document permissions. - Forgetting that the role applies organization-wide. ZIP permissions apply to all centers in the role's scope. To restrict by center, use Zenoti's center-level role assignment, not the ZIP permissions themselves.
- Trying to grant a permission you don't have visibility to. If
Manage Security Rolesis missing on your user, you'll see roles as read-only or not at all. Resolve the meta-permission first.
Frequently asked questions
Are these the only ZIP permissions?
Yes. The three permissions in the table above are the complete ZIP permission set. Two adjacent permissions (Manage Documents, View Documents) gate the document area; Leave Management uses its own permission set when enable_pto is on.
Do I need all three permissions to use ZIP?
No. Grant only what each role needs. A finance auditor who only pulls reports needs Access Payroll Payouts Reports and nothing else.
Can I grant ZIP permissions without holding them myself?
Yes. Granting permissions requires Manage Security Roles, not the permissions you are granting. A super-admin can configure payroll permissions without ever running payroll.
The role I want to edit isn't in the list.
Either the role doesn't exist (create it first), or your user lacks Manage Security Roles (you'll see roles as read-only or hidden). Check both.
The user has the permission but the menu still doesn't appear.
Have the user sign out and back in. Confirm the enable_payroll_payouts feature flag is on at the organization level — contact support@zenoti.com if you can't verify it.
Can I grant ZIP permissions per center? ZIP permissions follow Zenoti's standard role-scoping model: a permission on a role applies wherever that role is assigned. Center-level scoping is achieved by assigning the role only at the centers where the user should have access, not by varying the ZIP permission itself.