Understand queue reprocessing
Queue reprocessing is the engine that keeps your queue accurate throughout the day. Every time an appointment changes state -- a service starts, a guest is marked as no-show, a provider is reassigned -- the system automatically recalculates estimated wait times, reassigns providers, and updates queue positions. This article explains when reprocessing occurs, what it does, and how to work with its behavior.
On this page
- Before you begin
- When queue reprocessing occurs
- What reprocessing does
- How reprocessing affects provider assignments
- Prioritize guests with scheduled services over walk-in guests
- Multi-service appointments
- Reprocessing eligibility and cooldown
- Manual reprocessing
- Audit trail
- Related articles
Before you begin
- Queue reprocessing requires the Reschedule queue based on resource availability setting to be enabled at the center level (Configuration > Appointments, Essentials section of the center page; the row appears once Operate appointment book in Queue mode is on), with the queue enabled at both the organization and center levels.
- The Enable Admin Queue setting must be active at the organization level, and Operate appointment book in Queue mode must be enabled at the center level.
Note: When Reschedule queue based on resource availability is disabled, the queue does not automatically recalculate times or reassign providers after state changes. Wait times and positions remain static until manually refreshed.
When queue reprocessing occurs
Queue reprocessing triggers automatically after these events:
- A service starts -- the provider's availability changes, affecting estimated times for remaining appointments.
- A service completes -- the provider becomes available sooner, freeing time for waiting guests.
- An appointment is cancelled -- the slot is freed and the queue rebalances.
- A guest is marked as no-show -- the appointment is removed from calculations and other guests move up.
- A staff member manually requests reprocessing -- useful when external changes (such as a provider checking in or out) need to be reflected in the queue.
After each of these events, the system validates that reprocessing is eligible and then runs the recalculation.
What reprocessing does
During each reprocessing cycle, the system performs the following steps:
- Identifies appointments needing assignment. The system finds all waiting appointments that are missing a start time, end time, or provider assignment.
- Orders appointments by queue position. Appointments are sorted by their queue join time (the time they entered the queue), with earlier check-ins served first. When Prioritize guests with scheduled services over walk-in guests is enabled, scheduled-service guests are placed ahead of walk-in guests in the resolved ordering.
- Calculates cumulative appointment times per provider. For each provider, the system adds up the durations of all assigned services to determine when the provider will next be available.
- Assigns next available time slots. Each unassigned appointment receives an estimated start time based on when the next provider slot opens up.
- Updates provider assignments (when automatic assignment is enabled). The system assigns the provider with the highest idle time to appointments that need a provider.
- Updates queue positions. All waiting guests receive recalculated position numbers reflecting the new order.
- Updates the center wait time. The estimated wait time displayed at the top of the queue is recalculated.
- Triggers notifications. Guests who become next in line, reach a position threshold, or fall within a wait time threshold receive notifications (if configured).
- Broadcasts updates to all connected screens. All open queue screens refresh automatically to show the updated information.
How reprocessing affects provider assignments
When the Assign therapist based on idle time center setting is enabled, the reprocessing engine automatically assigns providers to waiting appointments. The system selects the therapist with the highest idle time who is qualified to perform the booked service.
However, not all appointments are eligible for automatic provider reassignment:
- Appointments with a locked provider assignment are excluded from automatic reassignment. The provider assignment remains exactly as set by staff, even though the estimated time may still be recalculated. Lock the provider assignment when a guest has specifically requested a provider.
- Appointments with a Specific provider preference retain their requested provider unless staff manually override the assignment.
- Gender preferences are respected. If a guest requested a male or female provider, only providers of that gender are considered during auto-assignment.
Prioritize guests with scheduled services over walk-in guests
When the Prioritize guests with scheduled services over walk-in guests center setting is enabled, the reprocessing engine places guests who have a scheduled (booked) appointment ahead of walk-in guests in the queue ordering. The setting governs how the queue resolves ordering when both scheduled-service guests and walk-in guests are checked in:
- Guests with a scheduled (booked) appointment are placed ahead of walk-in guests for the same provider, regardless of which guest checked in first.
- Walk-in guests are placed behind scheduled-service guests in the queue ordering.
- Wait time calculations adjust to reflect the resolved ordering.
This setting is useful for centers that want to honor scheduled bookings ahead of walk-ins — for example, when scheduled guests carry a higher service-level commitment.
Note: This is a scheduled-vs-walk-in priority setting, not a "called ahead" feature. The setting evaluates whether the appointment was booked in advance versus added as a walk-in; it does not evaluate phone-call history. Articles or training material that describe a "call-ahead prioritization" feature are referring to this same setting under an older name.
Multi-service appointments
For guests with multiple services booked in a single appointment, the reprocessing engine handles each service segment independently:
- Each segment can have a different provider assigned.
- Each segment has its own estimated start and end time.
- Completing one segment does not automatically complete the others.
- The reprocessing engine calculates each segment's time slot separately, which allows segments to be spread across different providers or scheduled back-to-back with the same provider.
Reprocessing eligibility and cooldown
To prevent excessive recalculations during rapid-fire status changes (for example, when staff are quickly processing multiple guests), the system enforces a short cooldown period:
- If a reprocessing request arrives while another reprocessing cycle is already running, the system skips the duplicate request and schedules a retry.
- The system checks that no main appointment has been updated very recently before starting a new cycle, avoiding conflicts with in-flight operations.
This cooldown ensures the queue stays responsive without consuming excessive system resources during peak hours.
Manual reprocessing
In addition to automatic triggers, staff can manually request a reprocessing cycle:
- In the queue dashboard, click the Reprocess Queue button (or equivalent action).
- The system validates eligibility, acquires a processing lock, and runs the reprocessing cycle.
- Wait for the reprocessing to complete -- the queue display refreshes automatically.
Manual reprocessing is useful when external changes have occurred that did not trigger automatic reprocessing, such as a provider checking in after the queue was already loaded.
Note: If another reprocessing operation is already running, the system skips the manual request and schedules a retry. You do not need to take further action -- the queue will update when the current cycle completes.
Audit trail
The reprocessing engine logs all provider and time changes for audit purposes. After each cycle:
- Provider reassignments are recorded with the old and new provider for each affected appointment.
- Start time changes are recorded with the old and new estimated time.
These records help managers review how the queue was managed throughout the day and understand why specific appointments were reassigned. The audit data is available through the appointment history and reporting tools.