View guests in a CohortDetail theme table
The CohortDetail view lists every guest assigned to a selected retention strategy theme, showing each guest's leaving-risk band and pattern strength side by side. Use this view to identify which guests belong to a specific theme, assess how strongly each guest fits that theme, and decide who to prioritize for outreach.
Audience: Front desk staff and managers who review at-risk guest lists and plan retention outreach within AI Retention Manager.
Before you begin
AI Retention Manager must be active for your organization. Access it by selecting Guest in the Zenoti left navigation.
You must have the following permission:
Permission: AI Retention Manager security object β View to open the dashboard and read the CohortDetail table. Edit is required to create target segments or send guests to AI Lead Manager. Admin path: Configuration > Security > Security roles > [your role] > AI Retention Manager
The guest table does not render until the first data fetch resolves. If the dashboard shows Loading guestsβ¦, wait a moment before concluding the list is empty.
Risk data is near real-time with a maximum delay of 24 hours.
Steps
Open the CohortDetail table for a theme
- In the Zenoti left navigation, select Guest to open AI Retention Manager.
- Select the Guests tab in the horizontal navigation row.
- On the Guests page, locate the guest cohort area. The page shows the count of guests who sit in at least one at-risk theme, with the note "guests sit in at least one at-risk theme. Click a card to see who and why."
- Click the card for the theme you want to review. The CohortDetail view opens and displays the guest table for that theme.
Note: The CohortDetail table does not display any rows until the initial guest data has fully loaded. This prevents an empty-list display that could be mistaken for a genuine result of zero guests.
Read the guest table columns
The table contains the following columns:
| Column | What it shows |
|---|---|
| Guest | The guest's name. |
| Center | The center associated with the guest record. |
| Churn | The leaving-risk badge, showing the risk band label and the percentage probability of leaving (for example, "High risk of churn Β· 74%"). |
| Dominance | The pattern-strength bar, representing how strongly this guest's behavior matches the selected theme (for example, "Pattern strength: 82%"). |
| Key signals | The behavioral signals driving this guest's placement in the theme. |
- The leaving-risk badge accessible label follows the format: <risk band> Β· <percentage>% β for example, "Critical risk of churn Β· 91%".
- The pattern-strength bar accessible label follows the format: Pattern strength: <percentage>% β for example, "Pattern strength: 68%".
- The four risk bands are: Critical risk of churn, High risk of churn, Monitor, and Healthy.
Filter the guest list by center (organization-wide scope only)
If your AI Retention Manager session covers the full organization, a center filter dropdown appears above the guest table.
- Select the center filter dropdown, which defaults to All centers.
- Choose a specific center to narrow the table to guests associated with that center.
- To return to the full list, select All centers from the dropdown.
Note: If you are working in single-center scope, the center filter dropdown is not shown. The table automatically displays guests for your center only.
Search for a specific guest
- Click the search field (placeholder text: Search guest name or ID).
- Type the guest's name or ID.
- To clear the search and return to the full list, select Clear.
If no guests match the current combination of theme and filter settings, the table displays: No guests match this cohort + filter combo.
Sort the guest table
Use the sort controls above the table to change the order of rows:
- Sort: Theme dominance β orders guests by how strongly their behavior matches the selected theme, highest first.
- Sort: Churn % β orders guests by their leaving-risk percentage, highest first.
Handle a guest data load error
If the guest data cannot be retrieved, the CohortDetail view displays a friendly error message such as "couldn't load these guests." No HTTP status codes or server error text are shown.
- Select Reload to attempt to fetch the guest list again.
- If the error persists, close the view and reopen it by clicking the theme card again.
- If repeated attempts fail, check your network connection or contact your administrator.
Important: The error message shown to you is intentionally simplified. No technical error details are exposed in the view.
Tips
- Start with the highest dominance scores. Guests with a high pattern-strength percentage are the clearest match for the theme. Prioritize outreach to these guests first, as the theme signals apply most reliably to them.
- Cross-reference the leaving-risk badge. A guest with a high pattern-strength score and a Critical risk of churn badge is your most urgent combination. Use both signals together, not either one alone.
- Use the center filter when reviewing multi-center performance. In organization-wide scope, filter to one center at a time to compare theme-level patterns across your locations without mixing guest populations.
- Search by ID when guest names are ambiguous. If multiple guests share a similar name, use the guest ID in the search field to locate the correct record immediately.
- Return to all themes with Back or All cohorts. To compare guest counts across themes without losing your place, use the Back button or select All cohorts to return to the theme card view.
Troubleshooting
| Problem | Resolution |
|---|---|
| The guest table appears empty immediately after opening the view. | Wait for the Loading guests⦠indicator to complete. The table does not display rows until the first data fetch resolves; an empty state shown before loading finishes is not a real result. Reload the page if the indicator does not clear after a reasonable wait. |
| The center filter dropdown is not visible. | You are in single-center scope. The center filter is only shown when your session covers the full organization. No action is needed β the table is already scoped to your center. |
| The error message "couldn't load these guests" appears. | Select Reload to retry. If the error persists, navigate away and return to the theme card, then click it again to reload the CohortDetail view. If the issue continues, contact your administrator. |
| The leaving-risk badge shows Monitor or Healthy for guests in an at-risk theme. | A guest can be in an at-risk theme based on behavioral patterns while still sitting in a lower-risk band overall. The theme reflects the behavioral signal; the band reflects the overall churn probability. Both are valid simultaneously. |
| Search returns no results even though you expect to find the guest. | Confirm that the center filter is set to All centers (in organization-wide scope) so the guest is not excluded by a center filter. Also verify the spelling of the guest's name or try searching by guest ID instead. |