Dashboard Localization β Multi-Locale UI String Support
AI Retention Manager displays all visible text β band labels, guest counts, narrative headings, campaign drawer copy, Help drawer content, and model status messages β from locale-specific resource files. When your organization's locale setting changes, the dashboard resolves every string from the appropriate file at render time rather than showing hardcoded English text.
Audience: Zenoti administrators who manage multi-locale organizations or who need to verify that AI Retention Manager displays correctly in a supported language.
Before you begin
AI Retention Manager must be active for your organization. If the dashboard is not yet available, see Set up onboarding and understand model training.
You must have 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.
The locale your organization uses must be one of the eight supported locales listed in the Supported locales section below. If your organization's locale is not on that list, the dashboard falls back to American English (en_US).
Locale selection is controlled at the organization level in Zenoti, not inside AI Retention Manager itself. Confirm your organization's locale setting with your Zenoti administrator before troubleshooting display issues.
Steps
Understand which strings are localized
Every visible string in AI Retention Manager is resolved from a locale resource file at render time. The following areas are fully localized β none of them use hardcoded text:
- Retention Groups β band labels such as Critical risk of churn, High risk of churn, Monitor, and Healthy, as well as guest counts within each band
- About this group panel β narrative headings and body copy, including How your business is shaping this group and Prediction signals
- Movement tracker β heading, subheading (How many guests moved between bands, and how long it took.), metric labels (Guests moved, Avg time to move, From first signal to band change), and placeholder states (Movement data is not available yet.)
- Client Watchlist β column headers (Guest name, Leaving risk, Marked since, Est. value missed, Value at risk, Last engagement, Last outreach), sort options (Sort: Risk (high to low), Sort: Risk (low to high), Sort: Guest name (A-Z)), empty states (No guests found in this band, No matching guests), and cohort filter labels (First time guests, Existing guests)
- Retention Score β the summary score label and the first-visit variant label (First time Guest Retention Score)
- Campaign drawer β all headings, instructions, field labels (Target Segment Name, Goal, Which guests, Focus on risk bands, Additional rules), option text (All guests in the targeted centers (default), Only guests who have purchased a membership at the targeted centers), segment status labels (Updates nightly, Fixed list (not refreshable)), and action buttons (Create and close, Create and go to Campaigns, Refresh member list)
- Model status messages β training banners (Training your Retention Manager, Usually ready within 24 hours, Get started, See what your Retention Manager can do), accuracy statements, and signal-list preparation notices
- Help drawer β all sections including routine steps, FAQ questions and answers, intro copy (This page is your daily shortlist of guests to reach out to before they drift away. You do not have to read any numbers.), section titles (Start here, Finding your way around, Common questions), and the footer note
- Navigation tabs β Overview, Guests, Proof of value, Reports, and How the Retention Manager works
- Error and loading states β for example, Loading guestsβ¦, No guests match this cohort + filter combo., Something went wrong loading this view, and We couldn't load performance right now. Please try again shortly.
Identify the supported locales
The dashboard resolves strings for exactly eight locales. If your organization is configured for any of these locales, AI Retention Manager displays in that language automatically.
The following table lists each supported locale and its locale code.
| Locale | Code |
|---|---|
| Arabic | ar |
| Danish | da |
| British English | en_GB |
| American English | en_US |
| Spanish β Spain | es |
| Spanish β Latin America | es_419 |
| French | fr |
| French β Canada | fr_CA |
Note: When no locale match is found, the dashboard defaults to American English (en_US). You do not need to configure anything inside AI Retention Manager β locale resolution is automatic once your organization's locale is set in Zenoti.
Understand how plural forms are handled
AI Retention Manager resolves plural noun forms per locale. Strings that include counts β such as guest counts in band labels, campaign drawer guest counts (Guest count in the segment:), and client watchlist pagination β display the grammatically correct singular or plural form for the active locale.
For example, a band with one guest displays "1 guest" rather than "1 guests", and a band with multiple guests displays the locale-appropriate plural. The same rule applies to service and visit nouns wherever they appear in the dashboard.
You do not need to configure plural handling. The locale resource files include both singular and plural forms, and the dashboard selects the correct form automatically based on the count it receives.
Verify localization is working correctly
Use the following steps to confirm that AI Retention Manager is displaying in the expected locale for your organization.
- Open the Guest menu in the Zenoti left navigation.
- Select AI Retention Manager from the menu.
- Review the Retention Groups section. Confirm that the four band labels β Critical risk of churn, High risk of churn, Monitor, and Healthy β display in the expected language.
- Open the Help drawer by selecting Help in the dashboard header. Confirm that the intro copy, section titles (Start here, Finding your way around, Common questions), FAQ questions and answers, and the footer note all display in the expected language.
- Navigate to the Guests tab. Confirm that column headers, sort options, empty-state messages, and cohort filter labels display in the expected language.
- If any strings display in American English when a different locale is expected, confirm with your Zenoti administrator that the organization's locale setting matches one of the eight supported codes listed above.
Note: Data shown in the dashboard β such as guest names, center names, and monetary values β is not affected by locale string resolution. Only UI labels and copy strings are localized.
Understand the Help drawer's localization scope
The Help drawer is fully localized. Every string inside it is resolved from locale resource files at render time. This includes:
- Intro copy β for example, "This page is your daily shortlist of guests to reach out to before they drift away. You do not have to read any numbers." and "The colours tell you who needs attention, and the signals tell you why."
- Section titles β Start here, Finding your way around, Common questions
- Routine steps β the instructional steps shown under each section
- FAQ questions and answers β all questions and their corresponding answers
- Footer note β the closing note at the bottom of the drawer, including the maximum data delay disclosure
Tip: If your front-desk staff report that the Help drawer text is not in their expected language, the most likely cause is that the organization's locale code does not match one of the eight supported locales. See Troubleshooting below.
Worked example: A French-speaking organization in Canada (locale code
fr_CA) opens AI Retention Manager. The Retention Groups heading, the four band labels (Critical risk of churn and its siblings), the Movement tracker subheading, the Client Watchlist column headers, and all Help drawer copy β including FAQ answers β display in Canadian French. A band containing one guest shows the singular form in French; a band with multiple guests shows the plural. The campaign drawer fields such as Target Segment Name, Focus on risk bands, and Create and go to Campaigns also display in Canadian French. No configuration is required inside the dashboard.
Tips
- Check the organization-level locale setting in Zenoti first before investigating a localization issue inside AI Retention Manager. The dashboard inherits the locale from the embedding session and cannot override it independently.
- When validating a locale change, navigate through all five tabs β Overview, Guests, Proof of value, Reports, and How the Retention Manager works β because some strings are rendered only within specific views.
- Use the Help drawer as a quick locale sanity check. Because every string in the drawer is localized, opening it and reading the intro copy is the fastest way to confirm that the correct locale resource file is loading.
- If your organization uses Spanish, confirm whether the Spain (es) or Latin America (es_419) locale code is configured, as the two use different vocabulary and plural conventions.
- Data values such as guest names, monetary amounts, and dates are not part of the locale string system and will always reflect the underlying data regardless of locale.
Troubleshooting
The dashboard displays in American English even though the organization's locale is set to a different language.
Confirm that the locale code configured in Zenoti exactly matches one of the eight supported codes (ar, da, en_GB, en_US, es, es_419, fr, fr_CA). A mismatch β for example, fr-CA with a hyphen instead of fr_CA with an underscore β causes the dashboard to fall back to en_US. Ask your Zenoti administrator to verify the exact code in the organization settings.
Some strings display in the expected locale but others remain in English.
Not all strings visible in the dashboard originate from the locale resource files. Guest names, center names, and raw data values are not localized. If the UI labels and copy strings are in the correct language but data values are in English, this is expected behavior and does not indicate a localization problem.
The Help drawer displays in English while the rest of the dashboard displays in the correct locale.
The Help drawer and the main dashboard surface both resolve strings from the same locale resource file. If the drawer is in English but the rest of the dashboard is not, reload the page using the Reload button. If the mismatch persists, confirm that the locale code is exactly correct and that the locale resource file for your locale is fully deployed. Contact your Zenoti administrator if the issue continues.
Guest counts in band labels display the wrong plural form (for example, "2 guest" instead of "2 guests").
Plural form handling depends on the locale resource file providing both singular and plural variants. If the plural form is incorrect, this may indicate that the locale resource file for your locale is incomplete. Note the specific string and locale code and report the issue to Zenoti Support so the resource file can be updated.
After switching the organization locale in Zenoti, the dashboard still shows the previous language.
The dashboard resolves locale strings when the page loads. Reload AI Retention Manager after the organization locale change takes effect. If the previous language persists after reloading, clear your browser cache and reload again.