Employee Listing V2 β Adoption Banner
When you open the employee listing page, Zenoti may display a banner inviting you to switch to the updated employee listing experience. This article explains what the banner means, the two states it can appear in, and how to act on it.
Audience: Administrators who manage employee records and want to evaluate or enable the updated employee listing.
On this page
- Before you begin
- How the banner works
- What the banner looks like
- Steps
- Tips
- Troubleshooting
- Related articles
Before you begin
- You must have access to the employee listing page at Employee > Employees.
Permission: View (under General Settings) β Required to view the employee list and search employees. Grant it on the General Settings row in the Employee Manager section of the security role (Configuration > Security > Security roles > the role > Permissions).
How the banner works
When you navigate to Employee > Employees, Zenoti checks whether the updated employee listing is already active for your organization. Based on that check, the page renders one of two banner states:
- Adoption-prompt state β The updated listing is not yet enabled. The banner invites you to try or enable the new experience.
- Already-enabled state β The updated listing is already active. The banner reflects that status instead of prompting you to enable it.
The banner is tied to the employee submenu and the organization setting that controls whether the updated listing is active. It appears only on the classic employee listing page; once the updated listing is enabled, the page itself changes and the adoption-prompt is no longer shown.
What the banner looks like
The banner appears near the top of the Manage employees page. Its content differs depending on whether the updated listing has been enabled.
| Banner state | When it appears | What it communicates |
|---|---|---|
| Adoption-prompt state | Updated listing is not yet enabled | Invites you to switch to the updated employee listing experience |
| Already-enabled state | Updated listing is already active | Confirms the updated listing is on; no further action is needed |
Steps
Respond to the adoption-prompt banner
When the updated employee listing is not yet enabled, the banner appears on the Manage employees page with a prompt to activate the new experience.
- Navigate to Employee > Employees.
- Review the banner that appears near the top of the page.
- Follow the on-screen option in the banner to enable the updated listing for your organization.
Note: Enabling the updated listing changes the default view of the Manage employees page for all users at your organization. If you want to review the updated listing before committing, test it in a non-production context first.
Important: Once you enable the updated employee listing, users will see the new experience when they navigate to Employee > Employees. Verify that your team is prepared for the change before proceeding.
Confirm the already-enabled state
If the updated listing is already active, the banner renders in its already-enabled state rather than showing a prompt.
- Navigate to Employee > Employees.
- If the banner indicates the updated listing is already on, no further action is required.
- The updated employee listing is your organization's current experience.
Tips
- If you see the adoption-prompt banner and are unsure whether to enable the updated listing, review the Employee listing article first to understand what changes with the new experience.
- The banner only appears on the classic employee listing page. After the updated listing is enabled, navigating to Employee > Employees opens the updated view directly.
- If the banner is not visible when you expect it, confirm that you have the View permission under General Settings in your security role. Without it, the listing page itself may not load.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| The adoption-prompt banner does not appear on the employee listing page | The updated listing is already enabled for your organization, or you do not have permission to view the listing | Check the banner state β if it shows the already-enabled message, no action is needed. If no banner appears at all, confirm your View permission under General Settings in your security role. |
| The banner appears but following its on-screen option has no visible effect | A permissions gap or a session state issue may be preventing the change | Refresh the page after acting on the banner. If the banner still shows the adoption prompt, contact your Zenoti administrator to verify the organization-level setting is saved correctly. |
| The banner shows the already-enabled state, but employees still see the old listing | The updated listing setting may have been enabled but not yet propagated to all sessions | Ask affected employees to log out and log back in. The updated listing view should load after a fresh session. |