Access and navigate the queue view
The queue view is a panel embedded within the appointment book that replaces the calendar grid with a real-time list of checked-in guests. This article explains how to open the queue, navigate its sections, and what to do when the queue does not load as expected.
Audience: Front desk staff who manage the queue on a daily basis.
On this page
- Before you begin
- Open the queue view
- Navigate the queue dashboard
- Display settings that change what the queue view shows
- Switch between queue views
- Reload the queue manually
- Support login restrictions
- Use view-only (PIN) mode
- Tips
- Troubleshooting
- Related articles
Before you begin
- The Enable Admin Queue setting must be enabled at the organization level, and Operate appointment book in Queue mode must be enabled at the center level.
- You must be logged in to the Zenoti admin interface with a center selected.
- At least one employee with the Therapist role must check in using the clock icon on the menu bar before services can be started and the Available Therapists section will populate.
Permission: Readonly (under Appointments) β Required to view the queue dashboard. Additional permissions are required to take actions within the queue (see Configure queue settings).
Open the queue view
- Navigate to Appointments in the top menu to open the appointment book.
- The appointment book opens in the queue view. If your center has Appointment and Queue view slide enabled, select Queue View from the Queue View / Appointment View dropdown at the left of the toolbar.
The queue dashboard replaces the calendar grid. All checked-in guests appear in the queue organized by progress state: waiting, being serviced, and completed.
Note: The queue view is only available when Enable Admin Queue is turned on at the organization level and Operate appointment book in Queue mode is enabled at the center level. The Queue View / Appointment View dropdown appears in the appointment book toolbar only when Appointment and Queue view slide is also enabled for the center; otherwise the appointment book always opens in the queue view. If you do not see the queue, ask your administrator to verify these settings.
Navigate the queue dashboard
The queue dashboard includes the following sections:
- Guests Waiting β Displays all checked-in guests waiting for service to begin. Cards are ordered by check-in time unless Prioritize guests with scheduled services over walk-in guests is enabled, in which case guests with scheduled appointments are listed ahead of walk-in guests.
- Guests Being Serviced β Displays appointments where a service has been started but not yet completed.
- Completed β Displays appointments where all services are finished and the guest is ready for checkout.
- Available Therapists section β A sidebar showing all checked-in therapists who are not currently serving a guest, sorted by idle time. This section appears when the Show available therapists in Admin Queue display setting is enabled. Depending on your organization's configuration, the sidebar may be labeled Available Therapists or Providers.
You can take actions on any appointment card by clicking the action buttons on the card directly, or by right-clicking the card to open the context menu (requires the ContextMenu action under Appointments).
Important: Before the queue can function and any service can be started, at least one employee with the Therapist role must check in to the queue using the clock icon on the menu bar. Until at least one therapist is checked in, the Available Therapists section stays empty and the start service action is unavailable.
What appears on each queue card
Each queue card in the Guests Waiting section can display the following information, depending on your center's display settings:
- Guest name and contact details
- Service or services and duration
- Assigned provider (or preference such as any provider, gender preference, or a specific provider)
- Estimated start time and estimated wait time
- Source indicator β showing whether the appointment originated from the web POS, mobile, kiosk, or online booking
- Guest wait time deviation (when Show guest wait time deviation is enabled)
- Guest queue number (visible only when the Show guest numbers in Queue view permission is granted β see Configure queue settings for permission path details)
- Unique guest identification number (when Show unique identification number for guests on queue card is enabled)
- Room association (when Show room association on Admin Queue is enabled)
- Walk-in start-time prefix (when Add a prefix to Start time to identify walk-ins guests is enabled)
Note: Call-ahead bookings made from the queue for a future time display a blue color band on their queue card, making them visually distinct from other cards.
Service completion and checkout
The queue handles service completion in two ways depending on whether a service was started before the invoice was closed:
- If staff close the invoice on a started appointment, the appointment is automatically marked Completed.
- If staff close the invoice on an appointment that was never started, the appointment must be manually marked Completed.
For payment processing from the queue, see Process payments from the queue.
Note: Check-in alerts in the queue view fire only for guests whom front-desk staff explicitly check in (from the queue, the appointment book, or the guest profile). Walk-in appointments booked and self-checked-in at a guest kiosk propagate into the queue but do not raise a check-in alert in this view.
Display settings that change what the queue view shows
Several display settings control what appears on queue cards and inside the queue view. Each is configured at the organization or center level under Configuration > Appointments > Queue.
- Show available therapists in Admin Queue β surfaces the Available Therapists sidebar.
- Show guest wait time deviation β adds the wait-time deviation indicator to each card. The displayed minimum threshold derives from the Minimum guest wait time center setting, a duration in minutes that gates service eligibility.
- Show unique identification number for guests on queue card β surfaces the guest's unique identifier on each card.
- Show marketing banner β shows a configured marketing banner inside the queue view.
- Show room association on Admin Queue β shows the room association on the queue card.
- Show walk-in appointments in pink color, in the Queue view β when enabled, walk-ins display in pink color in the queue view, making them visually distinct from blue colored call-aheads.
- Add a prefix to Start time to identify walk-ins guests β prepends a configured prefix to the start time on walk-in cards so staff can distinguish walk-ins at a glance.
- Show confirmation page in queue view β adds a confirmation page after queue actions.
- Appointment and Queue view slide β adds the Queue View / Appointment View dropdown to the appointment book toolbar; when off, a queue-mode center always opens in the queue view.
- Lock Queue and convert to view-only mode after a set duration of inactivity β locks the queue after a configured idle duration; staff must enter a PIN to unlock the queue and resume editing.
For a full reference of all queue settings, see Configure queue settings.
Switch between queue views
The queue toolbar includes a Walk-in button, a filter box for searching appointments by name, phone, or email, layout icons above the waiting list, a No show list button, a print icon, and a refresh icon. When Show available therapists in Admin Queue is on, an attendance control appears at the right of the toolbar as well. When Appointment and Queue view slide is on, the Queue View / Appointment View dropdown sits at the left of the appointment book toolbar.
Note: The appointment book toolbar remains accessible while the queue is open. You can access the booking wizard, POS (Point of Sale), and guest profile from the toolbar without leaving the queue view.
Print queue appointments
The print icon in the toolbar opens the Print Appointments dialog, which offers the following options:
- Open Appointments for the day
- All Appointments for the day
- Open Appointments for specific Provider
- All Appointments for specific Provider
- All sales for specific Provider
- Print all job cards for the day
Select the option that matches what you need and click Print.
Individual queue cards also have per-card print options in the horizontal ellipsis (β―) menu: Print Appointment (a basic information window) and Print job card (a detailed window). These are distinct from the toolbar print dialog.
Reload the queue manually
If you notice that the queue appears outdated β for example, an appointment that should be visible is missing β you can manually reload the queue:
- Click the refresh icon in the queue toolbar.
The system fetches the current queue data for the selected center and date. Changes made by one staff member appear automatically on other open queue screens; manual reload is useful after brief connection interruptions or when you suspect an automatic update did not arrive.
Note: When the organization-level setting that disables automatic queue reload is enabled, the queue uses incremental updates instead of full reloads to improve performance in high-volume environments. In this mode, clicking the refresh icon forces a complete data refresh.
Support login restrictions
When an administrator logs in using support access credentials, the queue automatically operates in read-only mode. Support access users can view queue data β appointment cards, provider assignments, wait times β but cannot modify appointment statuses, assign providers, or update guest information. This restriction is enforced automatically and cannot be bypassed.
Use view-only (PIN) mode
The queue supports a view-only mode that locks the interface after a period of inactivity. While in view-only mode, staff can see queue data but cannot modify appointments or take actions.
Activate view-only mode manually
- In the queue view, click your name in the bottom panel.
- Select PIN Mode.
The queue immediately locks. Any staff member can still see the queue but must authenticate to resume editing.
Unlock the queue
Click anywhere on the queue view to display the login prompt, then enter your credentials to exit view-only mode.
Automatic exit from view-only mode
There is no manual "Exit PIN Mode" button. View-only mode exits automatically when an employee navigates away from the appointment book to administrative functions. This behavior is controlled by the Exit PIN mode when employee exits appointment book setting.
Note: Before activating view-only mode, set the inactivity duration at the center level. The queue will also lock automatically after the configured idle period without requiring you to click PIN Mode manually.
Worked example: Your center is configured with a 10-minute inactivity timeout. A front desk staff member steps away to assist a guest at the retail counter at 2:00 PM without activating PIN mode manually. At 2:10 PM, the queue locks automatically. When they return and click the queue, they are prompted to enter their credentials before they can check in the next guest or start a service.
Tips
- If the Queue View / Appointment View dropdown does not appear in your toolbar, the Appointment and Queue view slide setting is not enabled for your center. The appointment book still opens in the queue view β the dropdown is not shown. Contact your administrator if you need to switch between views.
- Use the filter box in the toolbar to quickly locate a specific guest by name, phone, or email when the queue is busy with many cards.
- After a brief network interruption, click the refresh icon to force a full data reload rather than waiting for automatic synchronization to catch up.
- Keep at least one employee with the Therapist role checked in at all times during operating hours. Without a checked-in therapist, the start service action is unavailable for all guests in the queue.
- Walk-in cards with the pink color display and the start-time prefix enabled are the quickest visual way to distinguish walk-ins from call-ahead guests (blue color band) at a glance.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| The appointment book shows the calendar and offers no Queue View option | Enable Admin Queue is disabled at the organization level, or Operate appointment book in Queue mode is disabled at the center level | Contact your administrator to verify and enable both settings under Configuration > Appointments > Queue |
| Queue loads but shows no appointments | No appointments have been checked in today, or the filter box is narrowing results | Clear any text in the filter box, then confirm that guests have been checked in |
| Queue view loads but appears blank or shows an error | Browser caching or session issue | Refresh the browser or clear the browser cache and reload the page |
| Changes made by another staff member are not appearing | Automatic synchronization did not deliver the update | Click the refresh icon to manually reload the queue |
| The Available Therapists section is empty even though therapists are scheduled | No therapist with the Therapist role has checked in via the clock icon on the menu bar | Ask the relevant employee to check in; scheduled availability alone does not populate this section |
| Start service action is unavailable for all guests | No checked-in therapist is available | At least one employee with the Therapist role must check in using the clock icon before services can begin |