Manage class waitlist
Configure the class waitlist feature: enable waitlists per class, set the maximum waitlist capacity, choose between automatic and manual promotion of waitlisted students, and define the promotion notification window.
Note: This article covers the waitlist configuration. For the day-to-day operational waitlist actions front-desk staff and instructors take on the roster β adding a student to the waitlist, confirming a waitlisted student, processing no-shows on the waitlist β see Manage waitlist, sign-in, and no-show.
Audience: Studio administrators configuring class capacity and waitlist behavior.
On this page
- Before you begin
- What waitlist configuration controls
- Enable waitlists for a class
- Configure org-level waitlist defaults
- Promotion modes: Broadcast and Priority
- Related settings and permissions
- Impacts and considerations
- Troubleshooting
- Related articles
Before you begin
- Class waitlists are gated by the org-level setting
EnableWaitlistConfirmationfor the Priority promotion mode; the Broadcast mode does not require the setting. - Your user role must have permission to manage organization-level Fitness configurations.
- The Override Capacity and Waitlist Confirm permissions are required for staff who manually promote students from the waitlist.
What waitlist configuration controls
Class waitlist configuration covers four decisions:
- Whether the waitlist is enabled per class β set on the class General tab.
- Waitlist capacity β the maximum number of students who can queue on the waitlist before the waitlist itself is also full.
- Promotion mode β Broadcast (offer the open spot to every waitlisted student simultaneously) versus Priority (offer to the first student on the queue with a response timer; promote the next on timeout).
- Promotion notification window β for Priority mode, the time a waitlisted student has to confirm their spot before the offer rolls to the next student.
Enable waitlists for a class
- Open the class definition under Fitness > Classes.
- Click the class name to open the General tab.
- In the Capacity section, locate the Allow waitlist toggle and turn it on.
- Set Maximum waitlist size β the number of students who can queue on the waitlist when the class itself is full.
- Select the Promotion mode β Broadcast or Priority.
- For Priority mode, set the Response time field β the time (in minutes) a waitlisted student has to confirm their spot before the offer rolls to the next student.
- Click Save.
The waitlist is now active for every future session of that class.
Configure org-level waitlist defaults
Org-level defaults apply when a class does not override them.
- At the organization level, click the Configuration icon.
- Search for waitlist and open the waitlist confirmation settings listed under the Fitness group.
- Configure the org-level defaults:
- Default promotion mode β Broadcast or Priority.
- Default response time (Priority mode) β minutes.
- Remove unresponsive β when on, students who do not respond to a Priority offer within the response window are removed from the waitlist.
- Pause time limit β for Priority mode, the maximum time the waitlist can be paused while waiting for responses before forcing a Broadcast fallback.
- Click Save.
Promotion modes: Broadcast and Priority
| Mode | When a spot opens | Student UX | Best for |
|---|---|---|---|
| Broadcast | The open spot is offered to every waitlisted student simultaneously. The first to confirm gets the spot. | Confirm + Not now buttons appear in the Webstore and CMA. | High-demand classes where any of several waitlisted students would attend. |
| Priority | The open spot is offered to the first student on the queue. If the student does not confirm within the response window, the offer rolls to the next student. | Confirm + Decline buttons appear; a response-time countdown is shown. | Classes where queue order matters (for example, intro classes with sequential prerequisites). |
The two modes are mutually exclusive per class; choose one in step 5 of the Enable waitlists for a class procedure above.
Related settings and permissions
- Permission: Override Capacity (under Classes) β required to manually promote a student when doing so would exceed the configured class capacity.
- Permission: Waitlist Confirm (under Classes) β required to confirm a waitlisted student manually from the roster.
- Discontinue online booking when waitlist reaches β a separate threshold setting that stops Webstore and CMA bookings once the waitlist count reaches a configured maximum. See Discontinue online class booking based on waitlist (Round 4 carryover; configure once that article ships).
- Notification templates: Five waitlist-related templates fire across the lifecycle (Waitlist Spot Available, Waitlist Priority Spot Available, Waitlist Registration Cancelled, Waitlist Registration Confirmed, Waitlist to Registered). Configure them under Configuration > Notifications > Templates for email and text, in the Classes section.
Impacts and considerations
- Spot reservation during pending priority confirmations. When a Priority offer is outstanding, the class spot is reserved for that student until the response window closes β staff cannot enroll another student into that spot during this window.
- Center override. Center managers can override the org-level promotion mode and response time per center if the org allows center overrides.
- Audit log. Configuration changes are captured in the configuration audit log under Reports > Audit Log. Manual promotion and override actions are logged on the session roster audit log.
- Waitlist with fee. When a class has a waitlist fee, students on the waitlist are charged on join (for the placeholder) and refunded if they do not get promoted. The refund destination follows the org-level refund-for-classes setting.
Troubleshooting
- Students cannot join the waitlist. Check that Allow waitlist is on for the class AND that the Maximum waitlist size has not been reached.
- Priority offer is not rolling to the next student. Confirm Remove unresponsive is on at the org level. If the offer is stuck, check that the configured response time is not unrealistically long for the class window.
- Manual promotion is blocked. Confirm the staff member's role has both Override Capacity and Waitlist Confirm permissions.
- The Webstore is still accepting waitlist signups when the waitlist is full. Confirm the Discontinue online booking when waitlist reaches threshold is configured (Round 4 carryover) and the threshold matches the Maximum waitlist size on the class.