ZenotiHelp

Configure queue settings

ZTZenoti Docs Team Updated October 16, 2026 15 min readHow-to

The queue is controlled by a combination of organization-level and center-level settings. Organization-level settings define the overall queue capabilities available to all centers, while center-level settings allow each center to customize queue behavior for its specific operational needs. This article provides a complete reference of all queue settings, along with the permissions that control access to queue features.


On this page


Before you begin

  • You need administrator access at the organization level to modify organization-scoped settings.
  • You need administrator access at the center level to modify center-scoped settings.
  • Changes to settings take effect immediately for new queue operations. Existing appointments already in the queue are not retroactively affected by most setting changes.
  • The queue requires two enabling steps: turn on Enable Admin Queue at the organization level, then turn on Operate appointment book in Queue mode at each center where you want the queue available.

Permission: Edit (under Organizations) is required to modify organization-level settings. Center-level settings require Edit permission at the center scope.

Organization-level settings

Organization-level settings control the core queue capabilities that are available across all centers in your organization. These settings are configured at Configuration > Appointments > Queue.

Setting Description Default
Enable Admin Queue Activates the queue feature for the organization. This org-level toggle must be on before any center can use the queue. The corresponding center-level setting (Operate appointment book in Queue mode) must also be enabled at each center. When disabled, the queue view is unavailable across all centers. Disabled
Lock Queue and convert to view-only mode after a set duration of inactivity Locks the queue after a configurable idle duration. While locked, the queue is view-only — staff must enter a PIN to release the lock and resume editing. Prerequisite: set the inactivity duration at the center level. Staff activate view-only mode manually via bottom panel → click your name → PIN Mode. Exit is automatic via the companion setting Exit PIN mode when employee exits appointment book. Lives on the organization Queue > Setup page. Disabled
Enable Kiosk Activates the guest kiosk feature, which allows guests to self-check-in at a kiosk device. When enabled, kiosk check-ins add guests directly to the queue. Requires the center-level Enable Kiosk mode setting to also be enabled. For guest kiosk configuration, see the kiosk setup articles. Disabled
Allow guest services to start irrespective of the order in Queue Controls queue ordering enforcement. When enabled, staff can start any guest's service regardless of their queue position (flexible ordering); all appointment blocks are visually highlighted and the Skip button is removed from cards (only Left and Start remain). When disabled, the queue enforces first-in-first-served order and staff must serve guests in check-in sequence. Disabled
Allow only authorized employees to move guests from the status In Service to Waiting When enabled, undoing a service start requires manager or provider authorization. An authorization prompt appears when a staff member attempts to revert an in-progress appointment to waiting status. Disabled
Back to waiting time limit (in minutes) The number of minutes after a service has started beyond which authorization is required to undo the start. For example, if set to 5, undoing a start within the first 5 minutes does not require authorization, but undoing after 5 minutes does. Only applies when Allow only authorized employees to move guests from the status In Service to Waiting is enabled. 1 minute
Make it mandatory for employees to provide a reason if they move guest from the status Being Serviced to Waiting When enabled, staff must select a reason from a predefined list when undoing a service start. This creates an audit trail for tracking why services were reverted. The dropdown values come from the Reasons for queue moved back to 'in service' list. Impact: Enabling this setting results in inconsistent wait times for guests because the undo-start delay affects queue reprocessing calculations. Disabled
Make it mandatory for employees to assign a service provider before starting a service When enabled, a provider must be assigned to the appointment before the service can be started. The Start button is disabled until a provider is assigned. This is essential for centers that use "any available provider" bookings. Disabled
Edit and delete block out time in Queue When enabled, staff can create, edit, and delete block time entries for providers directly from the queue's Available Therapists section. When disabled, block time management is only available from the appointment book calendar views. Disabled
Show guest wait time deviation When enabled, each queue card displays the difference between the guest's originally scheduled appointment time and the current estimated start time. A positive deviation means the guest is expected to start later than originally scheduled. The label shown next to the deviation is entered in the companion Enter a label for guest wait time deviation field. Enabled
Enable Auto-Pay When enabled at the organization level, the queue supports automatic payment processing for completed appointments when the guest has a payment method on file. Requires the center-level auto-pay setting to also be active. For payment processing details, see Process payments from the queue. Disabled
Disable Pre-Authorization When enabled, the queue skips the pre-authorization step for auto-pay. Payment is charged directly when the service is completed instead of being pre-authorized at check-in. Only applies when Enable Auto-Pay is active. Disabled
Enable Print Appointment When enabled, the queue toolbar includes a print icon that opens the Print Appointments dialog with six 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, and Print all job cards for the day. Enabled
Enable a default service for all guests in Queue When enabled, all queue guests are automatically assigned a configured default service. The default service must be associated with the center and all providers must be configured for it. Disabled
Prioritize guests with scheduled services over walk-in guests When enabled, guests who have pre-scheduled appointments are served before walk-in guests, regardless of check-in order. Walk-in guests are placed after scheduled guests in the queue sequence. Disabled
Use employee transition time to calculate average guest wait times When enabled, the system factors in a configured employee transition time (in minutes) when calculating average guest wait times. The transition duration can be overridden at the center level. Disabled
Calculate enhanced wait times based on employee efficiency and guest's service durations in the past When enabled, wait time calculations draw on historical performance data. Configure the number of past service records to consider for: (a) employee past services, (b) guest past services, and (c) combined employee-guest past services. Disabled
Allow employees setting up time (in minutes) When enabled, a configurable number of minutes is added as setup time before each service starts. The center level can override the organization value on its Wait times page (When employee starts work, give employee this many minutes of time to set up: Use organization default or Override and instead use this as value). Disabled
Automatically move the appointments in the Appointment Book, based on start and complete actions When enabled, the Appointment Book automatically adjusts appointment blocks when services are started or completed in the queue. Slot rounding: on start, the block snaps to the actual start time rounded down to the nearest slot; on completion, the block snaps to the actual completion time rounded up to the nearest slot. Worked example: a 10:00–10:30 appointment started at 9:53 and completed at 10:13 displays as 9:50–10:15. Undoing a start does not reset the block to the originally scheduled time. Multi-service sequential scheduling: when a multi-service visit is started as a whole from the Queue, services are scheduled sequentially (each starts only after the previous ends). Also enables group start and complete for multiple appointments. Disabled
Show unique identification number for guests on queue card Surfaces the guest's unique identifier on the queue card alongside the guest's name. The number starts from 1 at the beginning of each day and increments in the order guest services are added to the queue. Disabled
Show marketing banner Displays a configured marketing banner inside the queue view. Disabled
Do not show past time slots on booking wizard When enabled, past time slots are suppressed from the booking wizard when a guest has services booked in the future. Disabled
Show start time in booking wizard When enabled, the start time column is visible in the booking wizard. Disabled
Show end time in booking wizard When enabled, the end time column is visible in the booking wizard. Disabled
Add a prefix to Start time to identify walk-ins guests Prepends a prefix to the start time on walk-in cards so staff can distinguish walk-in entries from scheduled entries at a glance. The prefix text is entered in the "For walk-ins, prefix Start time with label" field and pre-populates by default in the Start Time field inside the Booking Wizard when a walk-in is added from the queue. Disabled

Reasons for queue moved back to 'in service'

This is a separate organization-level configuration (editable at both the org and center level) that defines the list of reason values presented to staff when they undo a started appointment back to waiting status. The values in this list populate the dropdown that appears when Make it mandatory for employees to provide a reason if they move guest from the status Being Serviced to Waiting is enabled. Reasons can only be added at the org level but edited at both org and center level.

Center-level settings

Center-level settings allow each center to customize queue behavior for its specific operational patterns. These settings are configured at Configuration > Appointments > Queue at the center level. On the Appointment and Queue management page, the Queue section shows Operate appointment book in Queue mode, Automatically move the appointments in the Appointment Book, based on start and complete actions, and Show confirmation page in queue view directly, and opens General settings, Display, and Wait times as separate pages (each with an Appointment and Queue management > Queue breadcrumb).

Setting Description Default
Operate appointment book in Queue mode Activates the queue for this specific center. The org-level Enable Admin Queue setting must already be on. Once enabled, the appointment book for this center opens in the queue view (the Queue View / Appointment View dropdown appears when Appointment and Queue view slide is also on). Disabled
Show confirmation page in queue view Adds a confirmation page after queue actions. Disabled
Show available therapists in Admin Queue When enabled, the queue sidebar surfaces the Available Therapists section listing all therapists who are currently checked in. Disabled
Show scheduled therapist for the day in Queue When enabled, the queue sidebar shows all providers who are scheduled for the day, regardless of whether they have checked in. When both this setting and Show available therapists in Admin Queue are enabled, the sidebar combines both lists. The row appears on the center Display page only after Show available therapists in Admin Queue is turned on. Disabled
Assign therapist based on idle time When enabled, the queue reprocessing engine automatically assigns the therapist with the highest idle time to waiting appointments that need a provider. This distributes work evenly across the team. Disabled
Default service for new guests Selects the service that a guest who joins the queue for the first time is given by default (the setting shows your organization's guest label, for example Default service for new Client). Choose the service from the Select a Service list. Select a Service (none chosen)
For returning guests, use guest's service history as basis for default. When enabled, a returning guest's default service is based on the most common service(s) taken in their five most recent visits; new guests get the service defined in the row above. The setting shows your organization's guest label. Disabled
Enable automatic purge of no-show guests from queue When enabled, the queue automatically marks appointments as no-show when they exceed the configured timer limits. Requires Reschedule queue based on resource availability to also be active. See Manage no-shows and auto-purge for the per-source timer settings and the Bypass purge timer limit (in minutes) behavior. Disabled
Reschedule queue based on resource availability Activates the automatic queue reprocessing engine for this center (the row appears in the Essentials section of the center's Appointment and Queue management page once Operate appointment book in Queue mode is on). When enabled, the queue recalculates estimated times, reassigns providers, and updates queue positions after every state change (start, complete, no-show, cancel); the queue must also be enabled at the organization and center levels. When disabled, times and positions are static. Disabled
Calculate wait time based on Chooses the basis of the wait-time calculation on the center Wait times page: Appointment slot interval or Configured duration (in minutes). With the configured duration, the wait time uses a fixed number of minutes instead of the slot interval. Appointment slot interval
Employee Availability Source Controls how the system determines provider availability for queue wait-time calculations. Clocked-in availability (default): wait times are computed only from providers who have checked in via the clock icon on the menu bar — example results: 0 / 60 / 120 min. Scheduled availability: wait times are computed from providers on the schedule regardless of check-in status — example results: 0 / 30 / 60 min. Both options are visible only when Reschedule queue based on resource availability is enabled. Clocked-in availability
When a reprocessing event occurs, allow services scheduled in the future to have their start times modified to be earlier after guest checks in When enabled and a guest checks in earlier than their scheduled time, queue reprocessing proactively moves the appointment to the earliest available slot. For example: appointment at 11:00 AM, guest checks in at 10:00 AM, slot opens at 10:30 AM — queue moves appointment to 10:30 AM. Disabled
Make it mandatory to select a room for all bookings When enabled, every appointment must have a room assigned before the service can be started. The Start button is disabled until a room is selected. This setting lives under Configuration > Appointments booking rules, not on the Queue page. Disabled
Service forms enforced before start (platform-configured center option) When enabled for your center, all required service forms must be completed before a service can be started in the queue. The Start button is disabled until forms are submitted. This setting can be configured at the center level or inherited from the organization level. Disabled
Minimum guest wait time A duration in minutes that gates service eligibility — guests must wait at least this many minutes after queue join before becoming eligible for service. The displayed minimum-wait text shown on cards (for example, "15 min") derives from this same numeric value. This is a functional threshold, not a static display label. Empty
Enter label for no-show button Customizes the text of the no-show button on queue cards. For example, you might change it to "Left," "Did Not Arrive," or "Departed." No-Show
Set an auto-delete timer limit for walk-in guests (in minutes) The number of minutes after which a walk-in guest who has not been started is automatically purged from the queue as a no-show. Requires Enable automatic purge of no-show guests from queue to be active. Empty
Online checkin and guest in store timer limit (in minutes) The number of minutes after which an online-checked-in guest who is confirmed present in the center is automatically purged if their service has not started. Requires Enable automatic purge of no-show guests from queue to be active. Empty
Online checkin and guest not in store timer limit (in minutes) The number of minutes after which an online-checked-in guest who has not been confirmed present in the center is automatically purged as a no-show. Requires Enable automatic purge of no-show guests from queue to be active. Empty
Bypass purge timer limit (in minutes) The duration applied when staff invoke the bypass auto-purge action. The bypass replaces the appointment's remaining purge timer with this configured value — it does not add to the remaining time. Empty
Frequent Services Display Count The number of frequently booked services displayed in the quick-add service panel when creating appointments from the queue. 0

Display settings (queue view)

The following settings change what appears in the queue view itself. On the Appointment and Queue management page they are split across the organization's Queue > Display page and the center's Queue > Display page.

Setting Description Default
Appointment and Queue view slide Adds the Queue View / Appointment View dropdown to the appointment book toolbar so staff can slide between the calendar and the queue. When off, the appointment book at a queue-mode center always opens in the queue view. This is a center-level setting on the Display page. Disabled
Show walk-in appointments in pink color, in the Queue view When enabled, walk-in appointment cards display in pink in the queue view, making them visually distinct from blue-colored call-ahead cards. This color highlight is separate from the walk-in start-time prefix setting. Helper text: "When enabled, walk-ins will display in pink color, in the Queue view, making them visually distinct from blue colored call-aheads." Disabled
Show room association on Admin Queue Shows the room association on the queue card when the appointment is assigned to a room. Disabled
Show preferred time in Queue When enabled, displays the guest's preferred appointment time on the queue card alongside their wait time. Disabled

Queue permissions

Queue operations are governed by per-role permissions configured at Configuration > Security > Security roles > select the role > PERMISSIONS tab > expand the Queue & Pin module. The Queue items row holds the two queue check boxes (Authorized to move from Being Serviced to Waiting and Show guest numbers in Queue view); the Pin items row holds Honor auto PIN mode setting and Allow exiting pin mode. Selecting a check box grants the permission to that role; clearing it revokes the permission.

The following tables list all permissions that affect queue functionality.

Queue-specific permissions

All permissions in this table live under Configuration > Security > Security roles > select the role > PERMISSIONS > Queue & Pin > Queue items.

Permission action Description
Authorized to move from Being Serviced to Waiting Controls the ability to undo a service start, reverting an in-progress appointment to waiting status.
Show guest numbers in Queue view Controls the visibility of queue position numbers on queue cards. Granting this permission shows the position numbers; clearing it hides them.

Appointment permissions

Security Role Permission action Description
Appointments ADD Create new appointments in the queue, check in guests, and book walk-in appointments.
Appointments EDIT Modify appointment details including provider, time, services, room, and notes.
Appointments READONLY View appointment information in the queue without the ability to make changes.
Appointments DELETE Delete appointments from the queue.
Appointments ContextMenu Access the right-click context menu on queue cards, which provides quick actions.

Employee break permissions

Security Role Permission action Description
Employee Break ADD Create block time entries for providers from the Available Therapists section in the queue.
Employee Break EDIT Edit existing block time entries for providers.
Employee Break DELETE Delete block time entries for providers from the Available Therapists section.

Service and guest permissions

Security Role Permission action Description
Service Custom Data VIEW View service forms and custom data associated with appointments in the queue.
Guests View Private View level 1 private guest notes from the queue's guest notes popup.
Guests View Private 2 View level 2 private guest notes from the queue's guest notes popup.
Guests View Private 3 View level 3 private guest notes from the queue's guest notes popup.

Support login restrictions

When a support login user accesses the queue, the system automatically enforces read-only mode. Support login users can view queue data but cannot modify appointment statuses, assign providers, or update guest information. This prevents unauthorized changes during support sessions.

For detailed queue and kiosk administration settings, see Configure appointment queue and kiosk.

Was this article helpful?
Your feedback helps us improve our documentation.