Waitlists
ProRequires Events Manager Pro. Compare plans
When an event sells out, a waitlist lets visitors reserve a place in line. If a space frees up, because someone cancels or you raise the capacity, the first person in line is emailed a link to book it and the space is held for them for a set number of hours. If they don't book in time, the offer passes to the next person.
Joining a waitlist is free and takes no payment. The person only goes through the normal booking form, and pays, once a space is offered to them.
Turn on waitlists
-
Go to Events then Settings then Bookings then Waitlists and set Enable Waiting Lists? to Yes. The rest of the settings appear.
-
Review the limits: how many spaces one person can reserve, how many spaces the list holds, and how long an offer lasts. The defaults are one space per person, 25 spaces per list and 48 hours.
-
Decide which events get a waitlist with Event waitlist option. The default, Enabled by default, gives every event a waitlist unless you untick it on the event.
-
Click Save Changes.
The waitlist settings with their defaults.
Waitlist settings
| Setting | Default | What it does |
|---|---|---|
| Enable Waiting Lists? | No | Switches the feature on for the site. |
| Allow guest reservations? | Yes | Lets visitors join with a name and email, without logging in. Has no effect where a booking needs an account anyway, for example when the only tickets are for members. |
| Maximum spaces per booking | 1 | The most spaces one person can reserve on a waitlist. |
| Total spaces | 25 | How many spaces a waitlist can hold before it is full. |
| Waitlist approval expiry | 48 | Hours a person has to complete their booking once a space is offered. After that the offer is withdrawn and the next person is offered the space. |
| Allow event-specific settings? | Yes | Adds waitlist options to each event, so the limits above can be overridden per event. |
| Event waitlist option | Enabled by default | Disabled by default: an event has a waitlist only if you tick it on the event. Enabled by default: every event has one unless you untick it. Enabled for all: every event has one and it can't be switched off per event. |
| Allow ticket exclusions? | Yes | Adds an Exclude from Waitlist? checkbox to each ticket. |
Below these are the texts visitors see (Heading Content and Feedback Messages). They are covered in Change the wording.
Set the waitlist for one event
With Allow event-specific settings? on, each event's Bookings/Registration box has a Waitlist Options section.
Leave a field blank to use the site default shown beside it.
| Field | What it does |
|---|---|
| Enable Waitlist? | Whether this event has a waitlist. |
| Total Spaces | Spaces on this event's waitlist. Blank uses the site default, 0 means no limit. |
| Maximum Spaces Per Booking | The most spaces one person can reserve. Blank uses the site default, 0 means no limit. |
| Waitlist Approval Expiry | Hours an offered space is held. Blank uses the site default, 0 means the offer never expires. |
To keep a ticket out of the waitlist, such as a sponsor or staff ticket, edit the ticket and tick Exclude from Waitlist? in the ticket editor. Spaces freed on an excluded ticket are not offered to the waitlist, and go back on general sale to whoever is allowed to book that ticket.
What visitors see
A waitlist opens only when the event is fully booked, meaning every available space is taken. An event whose bookings are closed for another reason, such as a passed cut-off date, shows the usual closed message and no waitlist. Events with the Cancelled status never show one.
On a fully booked event the booking form is replaced by the waitlist form: a short explanation, then Email and Name fields for guests, a Spaces selector, and a Join Waitlist button.
A fully booked event with an open waitlist.
After joining, the visitor sees a confirmation with their position in line and receives the Waitlist Confirmed email. Returning to the event page shows their reservation details, their position, and a Cancel Reservation button.
Other states have their own messages:
| Situation | What the visitor sees |
|---|---|
| Guests can't join and the visitor is logged out | The Login text (Please log in to access the waitlist.) |
| The waitlist has no spaces left | The Waitlist Full text |
| The visitor canceled their reservation | The Cancelled text |
| An offer was made and ran out | The Expired text |
Logged-in visitors also find their waitlist reservation on their My Bookings page, with a link to cancel it and, once a space is offered, a Book Now link.
How spaces are offered
Events Manager checks the waitlist whenever space may have opened: when a booking is canceled, rejected or deleted, when a booking is edited, and when the event is saved (for example after you add spaces to a ticket).
- The list is worked through in the order people joined.
- The first person who can book a ticket that has space is offered it. Someone waiting for a members-only ticket is skipped when the free space is on a ticket they can't book, and the next eligible person is offered it instead.
- If the person at the front asked for more spaces than are free, nobody behind them is offered anything. The free spaces are kept for that person until enough have opened up.
- The reservation's status changes from Waitlist to Waitlist Approved and the Waitlist Approved email is sent, with a link to complete the booking.
- The link opens the event's normal booking form, with a notice that the spaces are reserved and for how long. The person chooses tickets, fills in the form and pays as any attendee would. While the offer is open, those spaces are meant to be held for that person. In our tests with Pro 3.10, a space freed by a cancellation went back on sale to everyone once the offer was sent, so check the event's availability after an offer goes out until this is fixed.
- If the booking isn't completed within the expiry time, the reservation becomes Waitlist Expired, the Expired Booking email is sent, and the space is offered to the next person. Expired offers are checked once a minute by WP-Cron.
The person can also decline: both the email link and the event page give them a way to cancel the reservation, which passes the offer on straight away.
Emails
Waitlists send four emails to the person waiting. Edit them in Events then Settings then Emails then Waitlists (the section appears once waitlists are enabled).
| Sent when | Default subject | |
|---|---|---|
| Waitlist Confirmed | Someone joins a waitlist | Waitlist Confirmation - #_EVENTNAME |
| Waitlist Approved | A space is offered to them | Waitlist Approved, Book Now! - #_EVENTNAME |
| Expired Booking | Their offer ran out before they booked | Waitlist Booking Expired - #_EVENTNAME |
| Cancelled Booking | They cancel their reservation | Waitlist Booking Cancelled - #_EVENTNAME |
Once the person completes a real booking, the regular booking emails take over. See booking email templates.
Change the wording
Every text a visitor sees can be edited in Events then Settings then Bookings then Waitlists.
Heading Content holds the blocks shown on the event page. HTML is accepted.
| Field | Shown |
|---|---|
| Login text | To a logged-out visitor who must log in to join. |
| Submit button | The label of the join button. Default Join Waitlist. |
| Already waiting | To someone who is on the list, with their position and reservation details. |
| Booking form | Above the booking form when a space has been offered. |
| Waitlist | Above the waitlist form. |
| Cancelled | After the visitor cancels their reservation. |
| Expired | After an offer has expired. |
| Waitlist Full | When the list has no spaces left. |
Feedback Messages are the short confirmations and errors shown when someone submits the waitlist form: Reservation confirmed, Already waiting, Already waiting (guest), Cancelled, Waitlist Full, Booking limit reached, More than available and Log in first.
Waitlist placeholders
These work in the waitlist texts and emails, alongside the usual event and booking placeholders. The full list is also in wp-admin under Events then Help.
| Placeholder | Output |
|---|---|
#_WAITLIST_EXPIRY | Hours an offered space is held for |
#_WAITLIST_LIMIT or #_WAITLIST_SPACES | Total spaces on the event's waitlist, or Unlimited |
#_WAITLIST_BOOKING_LIMIT | Most spaces one person can reserve |
#_WAITLIST_WAITING | Number of reservations waiting, not counting those already offered a space |
#_WAITLIST_AVAILABLE | Spaces left on the waitlist |
#_WAITLIST_BOOKING_POSITION | This person's position in line |
#_WAITLIST_BOOKING_EXPIRY | Time left on this person's offer |
#_WAITLIST_BOOKING_URL | Link where this person views, completes or cancels their reservation |
Conditional placeholders wrap text that should show only in some cases:
| Conditional | Shows its content when |
|---|---|
{has_waitlist} | The event has a waitlist enabled |
{waitlist_open} | The event is full and the waitlist is taking reservations |
{waitlist_full} | The waitlist is enabled and has no spaces left |
{waitlist_closed} | The waitlist is not taking reservations (full, not yet open, or not enabled) |
{has_waitlist_limit} | The waitlist has a limited number of spaces |
{has_waitlist_booking_limit} | There is a limit on spaces per person |
{has_waitlist_expiry} | Offers expire |
Manage the list in wp-admin
Waitlist reservations are stored as bookings with their own statuses, so you manage them in the bookings tables under Events then Bookings.
- Find them. Choose Waitlist in the status filter of a bookings table to list reservations that are waiting, offered or expired.
- See the queue. Add the Waitlist Position and Waitlist Expiry columns from the table's settings. An event's bookings screen also shows Waitlist spaces (reserved by people waiting) and Waitlist approved (offered and not yet booked) beside its availability figures.
- Act on one. The row actions depend on the status:
| Status | Actions |
|---|---|
| Waitlist | Approve (offer this person a space now, ahead of the queue), Cancel, Delete, Resend email |
| Waitlist Approved | Cancel, Delete, Resend email |
| Waitlist Expired | Approve (make the offer again, with a fresh expiry time), Cancel, Delete |
Approve offers the space without checking that one is free. Use it when you know you have room, for example after raising the event's capacity for that person.
Waitlist reservations can't be moved to another event.
Troubleshooting
The event is closed but no waitlist appears
Check, in order: that Enable Waiting Lists? is Yes; that the event has Enable Waitlist? ticked (or that Event waitlist option enables it); that the event is fully booked and not closed by its cut-off date or ticket sale dates; and that at least one ticket is not excluded from the waitlist. If you use a custom single event format, the form appears where #_BOOKINGFORM is.
Spaces freed up but nobody was offered them
The person at the front may have reserved more spaces than are free. The spaces stay on hold for them until enough open up. You can see how many they asked for in the bookings table, and either wait, cancel their reservation, or approve someone else by hand.
Offers never expire
Expiry runs on WP-Cron, which needs visits to your site or a real cron job to fire. See WP-Cron. Also check that Waitlist approval expiry is not 0, on the site and on the event.