Configure queue settings
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
- Organization-level settings
- Center-level settings
- Queue permissions
- Related articles
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.