New Booking Experience β Service Selection Overlay
The service selection overlay in the New Booking Experience is the panel where front desk staff browse and choose services for a guest's appointment. This article explains how the overlay organizes services, how search works, and how to select multiple services in a single pass.
Audience: Front desk staff who book appointments using the New Booking Experience.
Before you begin
The New Booking Experience must be enabled for your center. For setup steps, see Enable the new booking experience.
You must have permission to create or edit appointments.
Permission: Add Appointment or Edit Appointment β required to open the service selection overlay. Admin path: Configuration > Security > Security Roles > [your role] > Appointments > Add or Edit
An active guest must already be selected in the New Booking Experience before the overlay opens.
Steps
Open the service selection overlay
- From the appointment book, open the New Booking Experience slide-in panel.
- On the landing screen, select Select a service first to open the service selection overlay.
Browse services by category
The overlay displays services grouped under their parent category headers. Each header can be expanded or collapsed individually.
- Tap a category header to expand it and reveal the services it contains.
- Tap the same header again to collapse it.
- Scroll through the list to find additional categories.
Note: When the
showOnlyServiceListsetting is enabled for your center, services appear as a flat list with no category grouping and no Top Services section. All other overlay behavior described in this article still applies.
Use the Top Services section
When the Top Services section is visible, it appears at the top of the browse list above the category-grouped services.
- The section shows the most frequently booked services for the center, up to the number configured in your center settings (default is 5).
- The Top Services section appears only when no search is active. Typing a search query hides it and switches to search results.
- If the center's frequent-services count is set to zero, the Top Services section does not appear.
Find day packages
Day packages appear in a dedicated Day Package section at the bottom of the grouped service list, separated from regular service categories.
- Scroll past the regular category sections to reach the Day Package section.
- Select a day package to add it to the appointment.
Search for a service
- Tap the search field at the top of the overlay.
- Type the service name. The search activates only after you have entered at least 3 characters.
- Review the filtered results. The category-grouped list and Top Services section are hidden while search is active.
- To return to the full browse view, clear the search field or delete characters until fewer than 3 remain.
Note: Entering fewer than 3 characters clears the active search and restores the full browsed category view automatically.
Select multiple services using Add Multiple
When the Add Multiple toggle is available in the overlay, you can select more than one service before confirming the booking.
- Tap the Add Multiple toggle to turn it on. The toggle state changes to indicate it is active.
- Select each service you want to add. Selected services are staged for confirmation.
- When you have finished selecting services, tap Done at the bottom of the overlay to confirm the selection and add all staged services to the appointment.
Important: Turning the Add Multiple toggle off before tapping Done clears any services you have staged. If you switch the toggle off accidentally, you must reselect your services.
Note: The Add Multiple toggle and Done button appear only when the multi-service booking setting (
allowMultiple) is enabled for your center. If you do not see the toggle, your center is configured for single-service selection.
Understand overlay states
The overlay shows different indicators based on its current state.
| State | What you see |
|---|---|
| Loading | A loading indicator while the service list is being retrieved |
| No results from search | A No Results Found indicator |
| Empty browse list | A No Results Found indicator |
| Error during load | A No Results Found indicator, or a custom error widget if one has been configured for your center |
If the overlay shows No Results Found when you expect services to appear, verify that services are active and associated with your center. For service catalog configuration, see For service configuration, see topics in the services category.
Tips
- Use the search field to narrow results quickly when the service list is long. Remember to enter at least 3 characters before results filter.
- Expand only the categories you need. Collapsing unused categories makes it easier to scan the list.
- If you are booking multiple services for a single guest, use the Add Multiple toggle to select them all at once rather than opening the overlay separately for each service.
- The Top Services section reflects the most frequently selected services for your center. If a service you book often is not appearing there, your center administrator can review the frequent-services count setting.
Troubleshooting
The Top Services section is not visible.
The section is hidden when a search query of 3 or more characters is active. Clear the search field to return to the browse view. The section also does not appear if your center's frequent-services count is set to zero, or if showOnlyServiceList is enabled for your center.
Search is not filtering results. Confirm you have entered at least 3 characters. The search activates only after the third character is typed. Fewer than 3 characters restore the browse view without filtering.
The Add Multiple toggle is not visible.
The toggle appears only when multi-service booking is enabled for your center. If you do not see it, contact your administrator to confirm whether allowMultiple is turned on. Until it is enabled, select services one at a time.
The overlay shows No Results Found, but services exist in the catalog. This can occur if the services are not associated with your center or are currently inactive. For service configuration, see For service configuration, see topics in the services category.
The overlay shows No Results Found after an error. An error during loading displays the same No Results Found indicator (or a custom error widget, if configured). Refresh the New Booking Experience panel and try again. If the problem persists, contact your administrator.