AI Retention Manager β Security Permissions
This article explains how to configure security role permissions for AI Retention Manager in Zenoti. Use these settings to control which roles can view or modify the AI Retention Manager screen within the Guest Manager module.
Note: For conceptual background on the forms infrastructure, see Forms Overview.
Audience: Zenoti administrators who manage security roles for their organization.
On this page
Before you begin
You must have administrator access to the security role editor in Zenoti.
The AI Retention Manager module must be active for your organization before permissions take effect.
Review the default permission assignments described in Verify default permission assignments by role before making changes, to avoid unintentionally removing access from roles that need it.
You need the following permission to manage security roles:
Permission: You need access to the security role editor to make changes described in this article. Contact your Zenoti administrator if this section is unavailable to you.
Admin path: Configuration > Security > Security roles
Steps
Locate the AI Retention Manager security object
- Navigate to Configuration > Security > Security roles.
- Select the security role you want to configure.
- Within the role editor, scroll to the Guest Manager module section.
- Locate the AI Retention Manager row in the list of security objects under Guest Manager.
Grant View permission
The View permission allows members of a role to open and read the AI Retention Manager screen. It does not allow configuration changes.
- In the AI Retention Manager row, select the View check box.
- Select Save to apply the change.
Note: Roles that have access to the Guest Manager admin page receive View by default. See Verify default permission assignments by role for details.
Grant Edit permission
The Edit permission allows members of a role to write changes and update configuration within AI Retention Manager. Granting Edit without View is not recommended β assign both check boxes together for roles that need full access.
- In the AI Retention Manager row, select the Edit check box.
- Confirm that View is also selected for the same role.
- Select Save to apply the change.
Important: Granting Edit allows the role to make configuration changes within AI Retention Manager. Review which roles receive this permission carefully before saving.
Verify default permission assignments by role
Zenoti assigns the following defaults when AI Retention Manager is activated. Review these before customizing roles to avoid duplicating or conflicting with the out-of-box configuration.
The table below summarizes the default permission state for each role type:
| Role | Default permissions |
|---|---|
| Owner | View and Edit |
| Marketing Manager | View and Edit |
| All other roles with Guest Manager access | View only |
| Roles with no Guest Manager access | No permissions |
Important: If a role does not have access to the Guest Manager admin page, that role receives no AI Retention Manager permissions by default, even if AI Retention Manager is active for your organization. You must first grant Guest Manager access before AI Retention Manager permissions apply.
Tip: To give a front-desk role read-only access to AI Retention Manager, grant View only and leave Edit unselected. This prevents front-desk staff from changing AI Retention Manager configuration while still allowing them to see the screen.
Worked example: Your organization has a Center Manager role that has Guest Manager access but is not a Marketing Manager role. By default, Center Manager receives View only. If Center Managers need to make configuration changes in AI Retention Manager, navigate to Configuration > Security > Security roles, select the Center Manager role, locate AI Retention Manager under Guest Manager, select the Edit check box, and select Save.
Tips
- Always grant View alongside Edit for any role that needs to configure AI Retention Manager. A role with Edit but without View cannot open the screen to make changes.
- After adjusting security roles, ask a member of the affected role to log out and log back in to Zenoti for the changes to take effect in their session.
- Use the Owner or Marketing Manager role as a reference baseline when setting up a new role that needs full AI Retention Manager access β both receive View and Edit by default.
- If your organization uses a custom role modeled after Marketing Manager, verify that AI Retention Manager permissions were carried over, as custom roles may not inherit the same defaults as the seeded Marketing Manager role.
Troubleshooting
A user with Guest Manager access cannot see the AI Retention Manager screen.
Check that the View check box is selected for their role under AI Retention Manager in the Guest Manager section of the security role editor. If the check box is unselected, select it and save. Ask the user to log out and log back in.
A user can open AI Retention Manager but cannot save any changes.
The user's role has View but not Edit. Navigate to Configuration > Security > Security roles, select their role, locate AI Retention Manager under Guest Manager, select the Edit check box, and select Save.
The AI Retention Manager row does not appear under Guest Manager for any role.
AI Retention Manager may not be active for your organization. Contact your Zenoti administrator to confirm whether the module has been enabled for your account.
A role that previously had no Guest Manager access now needs AI Retention Manager access.
AI Retention Manager permissions are only available to roles that have Guest Manager access. First grant the role access to the Guest Manager admin page, then return to the security role editor to assign the appropriate AI Retention Manager permissions (View, Edit, or both).
After saving a role change, the affected user's access has not updated.
Permission changes take effect at the next login. Ask the user to log out of Zenoti and log back in. If the issue persists after re-login, confirm that the correct role is assigned to that user in their employee profile.