Configure role permissions for leave management
Set up role-based permissions for leave management features in Zenoti Integrated Payroll (ZIP). Assigning the correct permissions ensures that administrators, managers, and employees have appropriate access to leave types, leave policies, balances, and approvals.
Audience: Administrators who configure security roles for staff members who use leave management.
On this page
- Before you begin
- Leave management permissions
- Configure permissions
- Tips
- Troubleshooting
- Related articles
Before you begin
You need administrator access to configure role permissions.
The enable_pto feature flag must be active and your organization must have a Premier Tier subscription.
You must have the Manage Security Roles permission to grant or modify permissions on any role.
Permission: Navigate to Configuration > Security > Security roles, open the role you want to configure, and select the Permissions tab. The person making changes needs sufficient administrator access to edit security roles.
Leave management permissions
The following permissions are all located under the Employee Manager section within a security role. Enable only the permissions each role requires.
| Permission | What it controls |
|---|---|
| LeaveTypes β Add, Edit, and Delete | Create, edit, and delete leave type definitions |
| Leave Policies β View / Manage | View (View) or create, edit, and delete (Manage) leave policies |
| Leave Balances β View | View employees' leave balances; create leave on behalf of employees |
| Leave Balances β Manage | Manually adjust employees' leave balances |
| Leave Approvals β View / Manage | View (View) or approve and deny (Manage) employee leave requests |
| Auto Leave approval β Enable | Auto-approve own leave requests |
Note: The permission names Approve Time Off, Self-Approve Time Off, View PTO Balance, Edit PTO Balance, Leave Policy (Add/Edit/Delete), and Leave Types (Add/Edit/Delete) are retired names from a prior UI version. The current permission names and groupings are listed in the table above.
Configure permissions
Set permissions for a role
- Navigate to Configuration > Security > Security roles.
- Select the role you want to configure.
- Select the Permissions tab.
- Expand the Employee Manager section.
- Enable the appropriate leave management permissions for the role:
- LeaveTypes β Add, Edit, and Delete β for administrators who manage leave type definitions.
- Leave Policies β View or Manage β for administrators or managers who need to view or maintain leave policies.
- Leave Balances β View or Manage β for managers who review or adjust employee leave balances.
- Leave Approvals β View or Manage β for managers who review or process employee leave requests.
- Auto Leave approval β Enable β for employees whose own leave requests should be auto-approved.
- Select Save.
Worked example: A front desk manager needs to view leave balances and approve or deny leave requests, but should not be able to create or delete leave types. Enable Leave Balances β View, Leave Approvals β Manage, and leave all other permissions disabled for that role.
Who configures the configurator
The administrator who grants leave management permissions must themselves hold sufficient access to edit security roles. If you cannot save changes to a role, contact another administrator who holds the required access and ask them to add the necessary permissions to your role, or to make the changes on your behalf.
Tips
- Grant Leave Approvals β Manage only to roles that should approve or deny leave β such as center managers. Limit Auto Leave approval β Enable to roles where self-approval is appropriate for your organization's workflow.
- Grant Leave Policies β Manage only to administrators responsible for creating and maintaining leave policies. Most managers need only the View level.
- After saving a role, ask a test user in that role to log in and verify they can access the expected leave management screens before rolling out the change organization-wide.
- If a user reports they cannot see a leave screen, check both the permission level (View vs. Manage) and whether the enable_pto flag is active for the organization.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| A manager cannot see the Leave Policies tab | The role has no Leave Policies permission enabled | Navigate to Configuration > Security > Security roles, open the role, expand Employee Manager, and enable Leave Policies β View at minimum |
| A manager can view leave requests but cannot approve or deny them | The role has Leave Approvals β View but not Manage | Update the role to enable Leave Approvals β Manage |
| An employee's own leave request is not auto-approved | Auto Leave approval β Enable is not set for the employee's role | Enable Auto Leave approval β Enable on the role assigned to that employee |
| Changes to permissions are not saving | The administrator making changes lacks sufficient access to edit security roles | Have a higher-level administrator grant the necessary access or make the changes directly |
| A user reports they cannot access leave management at all | The enable_pto flag may not be active for the organization | Contact support@zenoti.com with your business name and FEIN β include "enable_pto activation" in the subject line |