Fitness CMA configuration
Use the Branding, Homescreen, and Shop tabs of the customer mobile app settings to control how your Fitness customer mobile app (Fitness CMA) looks and behaves β the theme, colors, shape, font, logos, and splash image; the widgets guests see on the home screen; and the web links listed in the app shop.
Audience: Organization administrators who manage fitness mobile app settings.
Availability: The Branding, Homescreen, and Shop tabs described in this article are visible only when Zenoti has enabled the Enable Fitness CMA setting for your organization. When this setting is not enabled, those tabs show the standard customer mobile app settings instead. The Enable Fitness CMA setting is visible only to Zenoti users with organization-creation rights. Contact Zenoti to enable it.
On this page
Before you begin
- You must have administrator access to your Zenoti organization.
- The Enable Fitness CMA setting must be active for your organization. If you do not see the Branding, Homescreen, or Shop tabs, contact Zenoti to enable it.
Permission: You need the CMA Settings permission to view and save branding settings. Admin path: Configuration icon > Online booking > Branding (within the CMA settings panel)
Steps
Configure the app appearance
Navigate to the Fitness CMA settings panel within Zenoti to access the Branding section.
Set the preferred appearance (light or dark)
The Preferred Appearance section lets you choose whether the Fitness CMA displays in light mode or dark mode. The selected mode is saved and applied across the app.
In the Branding panel, locate the Preferred Appearance section.
Select either Light Mode or Dark Mode.
- Light Mode β Uses a light background with dark text. Suitable for bright environments.
- Dark Mode β Uses a dark background with light text. Suitable for low-light environments.
Note: This setting controls the default appearance applied to the Fitness CMA. Dark Mode uses a different default background color β ensure your branding assets have sufficient contrast. For guidance, see the on-screen note: "This is the default background color for Dark Mode. Make sure your colors/branding assets should have contrast."
Select Publish.
Choose a color theme
The Color Theme section lets you select from preset color themes or define a custom theme using specific color values.
In the Branding panel, locate the Color Theme section.
Choose one of the following options:
Preset themes β Select a predefined color theme, including the default Aqua preset.
Custom theme β Define your own theme by entering color values for:
- Primary Button Background Color β The background color for primary action buttons.
- Primary Button Text Color β The text color on primary action buttons.
- Secondary Button Background Color β The background color for secondary action buttons.
- Secondary Button Text Color β The text color on secondary action buttons.
- Primary Button Background Color (Dark) β The primary button background in dark mode.
- Primary Button Text Color (Dark) β The primary button text color in dark mode.
- Secondary Button Background Color (Dark) β The secondary button background in dark mode.
- Secondary Button Text Color (Dark) β The secondary button text color in dark mode.
Select Publish.
Tip: Light mode and dark mode color values are configured separately. Switch between LIGHT MODE COLORS and DARK MODE COLORS sections to complete both sets.
Select a shape style
The Shape section controls the shape style applied to UI elements throughout the Fitness CMA, such as buttons and cards.
- In the Branding panel, locate the Shape section.
- Select the shape style you want to apply β for example, Rounded.
- Select Publish.
Select a font
The Font section controls the font family applied throughout the Fitness CMA. The default font is Inter.
In the Branding panel, locate the Font section.
Select one of the following available font families:
- Inter (default)
- Merriweather
- Noto Sans
- Rubik
- Raleway
- DM Sans
- Plus Jakarta Sans
- Open Sans
Select Publish.
Note: Font availability depends on the app version. Not all fonts may be available in earlier versions of the Fitness CMA. A note in the panel indicates this: "This will reflect with new version of the app."
Important: Font changes, along with splash image and app icon changes, reach guests only in a new release of the Fitness app. Guests on older builds β including the earlier customer mobile app (CMA v3) β continue to see the previous values until they update to a build that supports the new settings.
Upload logo images
The Top Navigation Header Logo section lets you upload separate logo images for light and dark themes. These logos appear in the top navigation bar of the Fitness CMA.
- In the Branding panel, locate the Top Navigation Header Logo section.
- Upload a logo for light mode:
- Select Upload & Save under the light mode logo upload control.
- Choose an image file. The recommended format is a horizontal logo with an aspect ratio between 2:1 and 4:1. Accepted formats: jpg, jpeg, or png. Recommended resolution: 400 Γ 120 px.
- Upload a logo for dark mode:
- Select Upload & Save under the dark mode logo upload control.
- Use the same format and resolution guidelines.
- Select Publish.
Important: Use a horizontal logo with an aspect ratio between 2:1 and 4:1. Logos outside this range may not display correctly in the navigation bar.
Upload a splash image
The Splash Image section lets you upload the image displayed while the Fitness CMA app loads.
- In the Branding panel, locate the Splash Image section.
- Select Upload & Save.
- Choose an image file. Accepted format: png. Recommended resolution: 800 Γ 600 px.
- Select Publish.
Important: Changes to the splash image take effect only with a new app version release. The panel displays the following note: "This will reflect with new version of the app." Plan splash image updates to coincide with scheduled app releases.
Configure home screen widgets
The Home Page Widgets panel lets you add, remove, and reorder the widgets that appear on the Fitness CMA home screen.
- Navigate to the Homescreen section of the CMA settings.
- In the Home Page Widgets panel, review the list of current home screen items.
- To add a new widget:
- Select Add item (or Add link for a Quick links entry).
- A slide-in sheet editor opens.
- Configure the widget details. The editor supports the following widget categories:
- Quick Links β Circular shortcut icons at the top of the home screen (up to 8 links).
- Marketing β Offers and promotions displayed as carousel banners on the home screen. Each spotlight is a carousel containing promotional banners.
- All Options β Additional configurable items.
- Select Save item to add the widget, or Cancel to discard.
- To edit an existing widget:
- Select the widget from the list.
- The slide-in sheet editor opens with the current settings.
- Make your changes.
- Select Save item to save, or Cancel to discard.
- To remove a widget, select the delete control next to the widget in the list.
- To reorder widgets, drag and drop them into the desired order.
- When you are satisfied with the home screen layout, select Publish to apply your changes.
Note: The Workout progress, Upcoming programs, and Workout programs widgets appear in the widget list only when Workout Builder is enabled for your organization.
Availability: Workout Builder is a beta feature. When Workout Builder is not enabled for your organization, the workout widgets are not visible in the widget list. When Workout Builder is enabled, the workout widgets are present but turned off by default.
Important: When Fitness CMA is enabled for your organization, the CMA settings page offers a single Publish action. The Save draft, draft view, and Draft preview controls are not present on the Branding, Homescreen, or Shop tabs.
Configure the shop
The Shop panel displays the list of items available in the Fitness CMA shop and lets you add and edit shop items. The Fitness CMA Shop creates and displays web-page items only. Each item has a Title, External URL, and an optional description and image.
Important: The Fitness CMA Shop supports web links only; gift cards cannot be added or configured here.
Important: The first save action on the Shop tab β any add, edit, delete, reorder, or image change β permanently removes any gift card shop items that were carried over from the earlier (non-Fitness) customer mobile app configuration. This action cannot be undone.
- Navigate to the Shop section of the CMA settings.
- Review the list of existing shop items.
- To add a new shop item:
- Select + Add item.
- A slide-in sheet editor opens.
- Configure the shop item details:
- Title β Enter a display name for the shop item.
- External URL β Enter the web page URL guests will be directed to.
- Description (optional) β Enter a brief description of the item.
- Image (optional) β Upload an image to display with the item.
- Select Save shop item to add the item, or Cancel to discard.
- To edit an existing shop item:
- Select the item from the list.
- The slide-in sheet editor opens.
- Make your changes.
- Select Save shop item to save, or Cancel to discard.
- Select Publish to apply your changes.
Note: Gift card settings are not configurable from the Fitness CMA Shop panel. To configure gift card settings, see Configure gift card settings.
Tips
- Use the Publish action directly. When Fitness CMA is enabled, the CMA settings page offers only Publish β there is no draft mode on the Branding, Homescreen, or Shop tabs. Changes take effect when you select Publish; font, splash image, and app icon changes reach guests only in a new release of the Fitness app.
- Upload both light and dark logo variants. Guests who switch between light and dark modes will see the appropriate logo. If only one variant is uploaded, the same logo may be used for both modes, which can reduce legibility in the other mode.
- Coordinate splash image and font updates with app releases. Because splash image and font changes take effect only with a new app version, schedule and test these updates as part of your next planned app release. Guests on older builds will continue to see previous values until they update.
- Keep quick link counts manageable. The Quick Links widget supports up to 8 links. Prioritize the actions guests use most frequently to avoid a cluttered home screen.
- Review carried-over shop items before your first save. The first save action on the Shop tab permanently removes any gift card shop items carried over from an earlier CMA configuration. Review the shop item list before making any changes if you want to note what was previously configured.
Troubleshooting
| Problem | Likely cause | Resolution |
|---|---|---|
| Splash image did not change after saving | Splash image updates require a new app version release | Schedule the image change with your next app release; the update will be visible after the new version is published |
| Logo appears distorted in the navigation bar | Logo aspect ratio is outside the recommended 2:1 to 4:1 range | Re-upload a horizontal logo with an aspect ratio between 2:1 and 4:1 at 400 Γ 120 px |
| Color changes are not visible in the app | Changes were not published | Select Publish in the CMA settings panel to make changes available to guests |
| Workout widgets are not visible in the widget list | Workout Builder is not enabled for your organization | Workout widgets appear in the list only when Workout Builder (beta) is enabled for your organization, and they are off by default |
| A gift card item disappeared from the shop after an edit | The first save action on the Shop tab removes carried-over gift card items | This action cannot be undone; gift card settings are not configurable in the Fitness CMA Shop |