Assign providers in the queue
Provider assignment is a core part of the queue workflow. When guests book with "any available provider" or when the originally booked provider is unavailable, front desk staff use the queue to assign or reassign providers before starting a service. This article covers the Available Therapists section, manual assignment, automatic assignment, provider preferences, and related settings.
Audience: Front desk staff who manage provider assignments during daily queue operations.
On this page
- Before you begin
- Available Therapists section
- Assign a provider to a waiting appointment
- Provider preference types
- Require provider assignment before start
- Auto-assign the highest idle time provider
- Create block-out times for providers
- Provider authorization
- Filter providers by service
- View services for a specific provider
- Show available vs. scheduled providers
- Lock a provider assignment during reprocessing
- Provider availability source
- Tips
- Troubleshooting
- Related articles
Before you begin
- The Enable Admin Queue setting must be turned on at the organization level, and Operate appointment book in Queue mode must be enabled at the center level.
- At least one provider must be checked in via the clock icon on the menu bar to appear in the Available Therapists section and to be available for assignment. Providers who have not checked in do not appear as available, regardless of their schedule.
- The Show available therapists in Admin Queue center-level display setting must be enabled for the Available Therapists section to appear in the queue sidebar.
Permission: Edit (under Appointments) — Required to assign or change providers on queue appointments.
Available Therapists section
The Available Therapists section (also referred to as Providers depending on your center's configuration) is a sidebar panel in the queue dashboard that displays all providers who are currently checked in and not actively serving a guest. The list is sorted by idle time, with the provider who has been idle the longest at the top.
Each entry in the Available Therapists section shows:
- Provider name and photo (if available)
- Idle time in minutes — how long since their last service was completed or since they checked in
- Actions available for each idle provider:
- Check out — ends the provider's shift, removing them from the available provider pool
- Block out — creates a block time entry for the provider (for example, a break or training session)
- Edit schedule — opens the provider's schedule for the day in the appointment book
The Available Therapists section updates in real time. When a provider finishes a service and returns to idle status, their entry reappears in the list with the idle timer reset to zero.
Note: The Block out action in the Available Therapists section requires the Edit and delete block out time in Queue setting to be enabled. Without this setting, you can still see idle providers but cannot create block time from the queue.
Assign a provider to a waiting appointment
To manually assign a provider to a waiting appointment:
- In the Guests Waiting section, select the appointment that needs a provider.
- Open the provider assignment panel (click the provider area on the queue card, or use the edit action).
- The system displays a list of available providers who can perform the booked service.
- Select the provider you want to assign.
- The system validates that the selected provider has an open time slot for the service duration.
Note: If the provider has a scheduling conflict, the assignment is blocked. Choose a different provider or adjust the appointment time.
- If validation passes, the provider is assigned to the appointment and the queue card updates to show the new assignment.
If the validation fails — for example, the provider has a scheduling conflict — the system displays an error and you need to select a different provider or adjust the appointment time.
After assigning a provider, the queue reprocesses to update estimated times for all remaining appointments.
Tip: To guarantee that a manually assigned provider is not changed by automatic queue reprocessing, lock the provider assignment after assigning. See Lock a provider assignment during reprocessing.
Worked example
A guest checks in for a 60-minute deep tissue massage booked with "any available provider." The Guests Waiting section shows the appointment with no provider listed. You open the provider assignment panel and see three checked-in providers sorted by idle time: Jordan (42 min idle), Sam (18 min idle), and Alex (5 min idle). You select Jordan, the system validates that Jordan has a free 60-minute slot, and assigns Jordan to the appointment. The queue card updates immediately and the estimated start time adjusts for all subsequent appointments.
Provider preference types
When a guest books an appointment, they can express a provider preference. The queue respects these preferences when assigning providers:
| Preference | Description |
|---|---|
| Any | The guest has no provider preference. Any available provider who can perform the service may be assigned. |
| Male | The guest prefers a male provider. The provider list filters to show only male providers. |
| Female | The guest prefers a female provider. The provider list filters to show only female providers. |
| Specific | The guest has requested a specific named provider. The queue locks the assignment to that provider unless staff manually override it. |
The preference type is set during booking and displayed on the queue card. Staff can override the preference during assignment if the guest agrees to an alternative.
Require provider assignment before start
When the Make it mandatory for employees to assign a service provider before starting a service setting is enabled, the queue blocks the start action until a provider is assigned to the appointment. This is essential for centers that use "any available provider" bookings, because it ensures someone is responsible for performing the service before it begins.
When this setting is active:
- The Start button on the queue card is disabled if no provider is assigned.
- Staff must assign a provider first (manually or through auto-assignment), then start the service.
- If the originally booked provider is unavailable, the system prompts staff to select a replacement.
When this setting is disabled, the queue allows starting a service even when the provider field shows "Any." In this case, the provider may be assigned retroactively.
Auto-assign the highest idle time provider
When the Assign therapist based on idle time setting is enabled at the center level, the queue reprocessing engine automatically assigns the provider with the highest idle time to waiting appointments that need a provider. This distributes work evenly across the team and minimizes the time any single provider sits idle.
Auto-assignment occurs during each queue reprocessing cycle. The system:
- Identifies waiting appointments that do not have a provider assigned (or that are booked with "any available provider").
- Finds the provider with the longest idle time who is qualified to perform the booked service.
- Assigns that provider to the appointment.
- Skips any appointment whose provider assignment is locked.
Auto-assignment respects provider preferences. If a guest requested a female provider, the system only considers female providers when selecting the highest idle time match.
Note: Auto-assignment does not override existing specific provider assignments. If a guest booked a specific provider, the system does not reassign them to a different provider even if another provider has been idle longer.
Create block-out times for providers
When the Edit and delete block out time in Queue setting is active, staff can create, edit, and delete block-out times for providers directly from the Available Therapists section — without leaving the queue view.
Create a block-out time
- In the Available Therapists section, click the provider's name.
- Click Block out. A block-out form opens.
- Enter the start time and end time for the block-out.
- One-off block-out: complete the form and save.
- Recurring block-out: select the Repeat checkbox, then:
- From the Repeats dropdown, select the recurrence type (daily, weekly, etc.).
- From the Repeat every dropdown, select the frequency (every 1, every 2, etc.).
- Set the start date and end date for the recurrence.
- Save the block-out.
The provider's block-out time appears in their schedule and prevents appointments from being assigned to them during that window.
Edit or delete a block-out time
- Click the provider's name in the Available Therapists section.
- Locate the block-out entry you want to modify.
- Click the edit icon to update the block-out details, or the delete icon to remove it.
- For recurring block-outs, the delete action offers two options: delete only the current day's instance, or delete all recurring instances.
Note: Block-out management requires the Edit and delete block out time in Queue setting to be enabled. If this setting is off, the Block out action does not appear in the Available Therapists section.
Provider authorization
When the Enforce therapist authorization setting is enabled at the center level, certain queue actions require the assigned provider to enter their authorization code before the action is processed. This adds a layer of accountability by confirming that the provider is aware of and agrees to the action being taken on their behalf.
When provider authorization is active:
- The staff member initiates an action (such as assigning a provider or starting a service).
- The system displays an authorization prompt.
- The provider enters their authorization code.
Note: The system validates the code and, if valid, completes the action.
If the code is invalid, the action is blocked and the staff member must try again or contact a manager.
Filter providers by service
When assigning a provider to an appointment, the system automatically filters the provider list to show only providers who are qualified to perform the booked service. This prevents accidental assignment of providers who are not trained or licensed for the service.
If the appointment has a specific service already selected, the provider list shows only providers qualified for that service. If the appointment has multiple service segments, the list filters based on the segment being assigned.
View services for a specific provider
To view all services that a particular provider can perform:
- In the Available Therapists section or provider assignment panel, select a provider.
- Click View Services (or equivalent action).
Note: The system displays the complete list of services the provider is qualified to perform at the current center.
This is useful when you need to add a service to an appointment and want to confirm the assigned provider can perform it, or when reassigning a multi-service appointment.
Show available vs. scheduled providers
Two center-level settings control which providers appear in the queue's provider panels:
Show available therapists in Admin Queue. When enabled, the queue sidebar surfaces the Available Therapists section listing all providers who are currently checked in (available). This is the default behavior and is ideal for centers that rely on real-time provider availability.
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 yet. This gives staff visibility into who will be available later in the day.
Both settings can be enabled at the same time. When both are active, the sidebar combines checked-in providers and scheduled providers into a single list, with a visual indicator distinguishing those who are checked in from those who are scheduled but not yet checked in.
Lock a provider assignment during reprocessing
Queue reprocessing recalculates provider assignments for waiting appointments. In some cases, you may have manually assigned a specific provider to an appointment and do not want the reprocessing engine to change that assignment.
You can lock the provider assignment on individual appointments to prevent reprocessing from changing it. When the provider assignment is locked on an appointment:
- The reprocessing engine skips that appointment when reassigning providers.
- The provider assignment remains exactly as set by the staff member.
- Time slot recalculation still applies — only the provider assignment is locked.
This is useful when a guest has specifically requested a provider and you want to guarantee that the assignment is not changed by automatic queue reprocessing.
Provider availability source
The Employee Availability Source setting at the center level (visible when Reschedule queue based on resource availability is on) controls how the system determines which providers are available for assignment:
- When set to Clocked-in availability (default), the system only considers providers who have completed their employee check-in for the day. Providers who are scheduled but not yet checked in are excluded from the available pool.
- When set to Scheduled availability, all providers on the day's schedule are considered available, regardless of check-in status.
This setting affects both the Available Therapists section and the provider options presented during manual assignment. Adjust this setting based on how strictly your center enforces employee check-in before serving guests.
For queue and kiosk settings configuration, see Configure queue settings.
Tips
- Sort by idle time to distribute work evenly. The Available Therapists section lists providers with the longest idle time at the top. Assigning from the top of the list naturally balances workload across your team without manual tracking.
- Lock assignments for guest-requested providers. After manually assigning a provider a guest specifically asked for, lock the assignment immediately. This prevents queue reprocessing from automatically reassigning that provider to a different appointment.
- Use gender preference filtering early. If a guest has expressed a gender preference, the provider list filters automatically — but verify the preference is set correctly on the queue card before assigning, especially for walk-in appointments where the preference may not have been captured at booking.
- Enable both provider display settings for maximum visibility. Turning on both Show available therapists in Admin Queue and Show scheduled therapist for the day in Queue gives your front desk a complete picture: who is available right now and who is coming in later, so staffing gaps can be identified and addressed before the queue backs up.
- Check provider qualifications before a multi-service reassignment. When reassigning a provider on an appointment with multiple service segments, use the View Services action to confirm the replacement provider is qualified for every segment — not the first one.
Troubleshooting
The Available Therapists section is not visible in the queue sidebar. The Show available therapists in Admin Queue center-level display setting is likely disabled. Ask an administrator to enable it under Configuration > Appointments > Queue. Also confirm that at least one provider has checked in via the clock icon on the menu bar — the section appears but shows no entries if no one has checked in.
A provider I want to assign does not appear in the provider list. Check whether the provider has checked in for the day. If the Employee Availability Source is set to Clocked-in availability, only checked-in providers appear. Alternatively, the provider may not be qualified to perform the booked service — the list filters automatically by service qualification. Verify the provider's service assignments in their employee profile.
The Start button on a queue card is greyed out even though a service is booked. The Make it mandatory for employees to assign a service provider before starting a service setting is enabled and no provider has been assigned to this appointment. Assign a provider using the provider assignment panel, then attempt to start the service again.
Provider authorization prompt appears unexpectedly during assignment. The Enforce therapist authorization setting is enabled at the center level. The assigned provider must enter their personal authorization code to complete the action. If the provider is not present, contact a manager who can authorize the action on their behalf.
A provider assignment I set manually was changed by the system. Queue reprocessing ran and reassigned the provider because the assignment was not locked. To prevent this, lock the provider assignment on the appointment immediately after assigning. Once locked, the reprocessing engine skips that appointment when redistributing providers.
The provider list shows providers who are not scheduled today. The Employee Availability Source is set to Scheduled availability, which includes all providers on today's schedule regardless of check-in status. If your center requires providers to be checked in before being assignable, ask an administrator to change this setting to Clocked-in availability under Configuration > Appointments > Queue.