ZenotiHelp

Cohort switch error recovery β€” restored previous cohort on failure

ZTZenoti Docs Team Updated October 25, 2026 5 min readGuide

When you switch between the Repeat Guests and First time Visitors cohort tabs in AI Retention Manager and the data request fails, the dashboard automatically restores the cohort you were viewing before the switch. The tab selection and the URL both revert to the previous state, and the panel content stays visible so your work is not interrupted.

Audience: Front desk staff and managers who use AI Retention Manager to monitor guest retention.

Before you begin

  • AI Retention Manager must be accessible from the Guest menu in the Zenoti left navigation. If the menu item is not visible, ask your administrator to check your security role.

  • You need the following permission:

    Permission: AI Retention Manager security object β€” View to open the dashboard and read it; Edit to create target segments, refresh member lists, and send guests to AI Lead Manager. Set per role at Configuration > Security > Security roles.

Steps

Understand the automatic recovery behavior

When a cohort switch fetch fails, the dashboard performs silent error recovery rather than replacing the page with an error screen. You do not need to take any manual steps to trigger recovery β€” it happens automatically.

The recovery does the following:

  • Restores the active tab β€” The cohort tab (either Repeat Guests or First time Visitors) that was selected before you attempted the switch is re-selected. The tab you tried to switch to is deselected.
  • Restores the URL β€” The URL in your browser's address bar is updated to reflect the restored cohort, not the one that failed to load. This means bookmarks and shared links continue to reflect a valid state.
  • Keeps panel content visible β€” The Overview, Retention Groups, About this group panel, Movement tracker, and Client watchlist all remain visible with the data from the previously active cohort. The page does not collapse to a no-data state or display an onboarding screen because of the failed network request.

Identify that a cohort switch has failed and been recovered

There is no error takeover screen. When recovery has occurred, the visible indicators are:

  1. The cohort tab you attempted to select is no longer highlighted β€” the tab for your previous cohort is active instead.
  2. The dashboard content continues to show data for the restored cohort.
  3. The URL reflects the restored cohort, not the one you tried to switch to.

If you are unsure whether recovery has occurred, check which cohort tab is currently selected and compare it with the cohort whose data is displayed in the Retention Groups section.

Retry a failed cohort switch

If you want to switch to the cohort that failed to load, try again after a brief pause:

  1. Wait a moment to allow any transient network issue to resolve.
  2. Select the cohort tab you want β€” either Repeat Guests or First time Visitors.
  3. If the switch succeeds, the dashboard updates to display data for that cohort.
  4. If the switch fails again, the dashboard restores the previous cohort a second time. Retry when your network connection is stable.

Note: The dashboard does not display a banner or notification to indicate that a cohort switch failed. If the tab you selected is not highlighted after switching, a recovery has occurred and you should retry.

Distinguish a cohort switch failure from other error states

Not all errors in AI Retention Manager involve cohort switching. Use the table below to tell them apart.

Situation What you see Action
Cohort switch fetch fails Previous cohort tab remains active; panel content stays visible; no error screen Retry the tab switch
Page-level unexpected error Something went wrong loading this view heading; Reload button displayed Select Reload
Cohort data unavailable ("Could not load cohorts:") Could not load cohorts: message in the cohort area Wait and reload the page

Tips

  • If a specific cohort tab consistently fails to load, check your network connection and then reload AI Retention Manager from the Guest menu.
  • The automatic restoration keeps your current view intact, so you can continue reviewing the Client watchlist or About this group panel while you wait to retry the switch.
  • Because the URL is restored along with the tab state, you can safely copy or bookmark the URL after a recovery β€” it will point to the cohort whose data is actually displayed.
  • If the First time Visitors cohort tab always fails for your organization, ask your administrator to verify that your organization's data includes first-time guest records within the expected data window.

Troubleshooting

The cohort I selected did not activate, but I do not see any error message.

This is expected behavior. When a cohort switch fetch fails, the dashboard restores the previous cohort silently. No error message or banner is displayed. Select the tab again to retry.


The panel content disappeared and I see an onboarding or no-data screen after switching cohorts.

A cohort switch network failure does not cause the panel to collapse. If you see an onboarding screen or a no-data state, the cause is likely a separate issue β€” for example, your session may have expired, or the dashboard may not have completed its initial data load. Close and reopen AI Retention Manager from the Guest menu.


Selecting the same cohort tab repeatedly does not load new data.

Each tab selection triggers a fresh data request. If repeated attempts all fail, the network issue is persistent rather than transient. Check your internet connection, reload the page, and retry. If the problem continues, contact your administrator.


The URL in my browser shows a different cohort than the tab that is highlighted.

If you observe this state briefly during a tab switch, it means a fetch is in progress. After a successful switch, the URL and tab will match. After a failed switch, the dashboard restores both the tab and the URL to the previous cohort β€” so they should match again within a moment. If they remain out of sync after the page settles, reload AI Retention Manager.


I need to work with the cohort that keeps failing to load.

If one cohort tab consistently fails, use the Reload option if a page-level error has occurred, or reload the page from the Guest menu. If the cohort still does not load after multiple attempts across different sessions, let the team know so the issue can be investigated.

Was this article helpful?
Your feedback helps us improve our documentation.