{"id":5053,"date":"2026-04-24T12:38:30","date_gmt":"2026-04-24T10:38:30","guid":{"rendered":"https:\/\/cevento-plugin.com\/docs\/005-waitlist\/"},"modified":"2026-04-24T12:38:30","modified_gmt":"2026-04-24T10:38:30","slug":"005-waitlist","status":"publish","type":"docs","link":"https:\/\/cevento-plugin.com\/en\/docs\/005-waitlist\/","title":{"rendered":"Waitlists"},"content":{"rendered":"\n<p>Cevento allows you to enable overbooking using waitlists. This means that users can book a spot on the event even if there are no more available spots. All waitlisted bookings are stored as regular booking with a specific waitlist status.<\/p>\n<h2 id=\"enabling-the-waitlist\">Enabling the Waitlist<\/h2>\n<p>The waitlist is activated per event. Open the event editor and find the <span class=\"cevento-docs__term\">Bookings<\/span> settings. Enable the option <span class=\"cevento-docs__term\">Booking Waitlist<\/span>. Once enabled, users who submit the booking form after the event has reached its capacity are put on the waitlist instead of receiving a regular booking confirmation.<\/p>\n<p><mark class=\"cevento-docs__notice\">The waitlist only activates when the event has a maximum capacity set. Without a capacity limit, every submission is accepted as a normal booking regardless of this setting.<\/mark><\/p>\n<p>A global default can be set under <span class=\"cevento-docs__term\">Cevento &rarr; Settings &rarr; General &rarr; Booking Waitlist<\/span>. Event-level settings always take precedence over the global default.<\/p>\n<h2 id=\"how-the-waitlist-works\">How the Waitlist Works<\/h2>\n<h3>Free Events<\/h3>\n<ol>\n<li>A user submits the booking form after the event is full. Their booking is saved with the status <span class=\"cevento-docs__term\">Waitlist<\/span> and does <strong>not<\/strong> reserve a spot.<\/li>\n<li>An automated notification email is sent to the user confirming they are on the waitlist (see <a href=\"#email-templates\">Email Templates<\/a> below).<\/li>\n<li>The administrator reviews the waitlisted booking in the booking table and either <strong>accepts<\/strong> or <strong>declines<\/strong> it.\n<ul>\n<li><strong>Accept<\/strong> &mdash; the booking is confirmed immediately. Status changes to <span class=\"cevento-docs__term\">Confirmed<\/span> and a confirmation email is sent to the user.<\/li>\n<li><strong>Decline<\/strong> &mdash; the booking is cancelled. Status changes to <span class=\"cevento-docs__term\">Cancelled<\/span>. No email is sent to the user.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h3>Paid Events (WooCommerce Integration)<\/h3>\n<p>The flow for paid events includes an additional payment step:<\/p>\n<ol>\n<li>A user submits the booking form after the event is full. Their booking is saved with the status <span class=\"cevento-docs__term\">Waitlist<\/span> and does <strong>not<\/strong> reserve a spot or count toward capacity.<\/li>\n<li>The user receives a waitlist notification email.<\/li>\n<li>The administrator accepts the waitlist booking via the <span class=\"cevento-docs__term\">Accept<\/span> action. The booking status changes to <span class=\"cevento-docs__term\">Waiting for Payment<\/span>.<\/li>\n<li>The user receives an automated email containing a <strong>payment link<\/strong> &mdash; a link that adds the booking directly to the WooCommerce cart and redirects to checkout.<\/li>\n<li>The user completes the payment. Once confirmed by WooCommerce, the booking status changes to <span class=\"cevento-docs__term\">Paid<\/span> and the spot is reserved.<\/li>\n<\/ol>\n<p><mark class=\"cevento-docs__notice\">Only one checkout session can be active for a given booking at a time. When a user opens the payment link, a <strong>30-minute checkout window<\/strong> is reserved exclusively for that session. During those 30 minutes, no other session can use the same link. If the window expires without a completed payment, the link becomes usable again. The payment link itself stays valid for 7 days and can be reused as often as needed within that period &mdash; use <span class=\"cevento-docs__term\">Resend Payment Link<\/span> only if you want to invalidate the current link and issue a fresh one.<\/mark><\/p>\n<p><mark class=\"cevento-docs__tipp\">Waitlisted bookings and bookings with status <span class=\"cevento-docs__term\">Waiting for Payment<\/span> are never automatically abandoned by the 10-minute pending expiry. Only regular pending bookings are subject to that timeout.<\/mark><\/p>\n<h2 id=\"waitlist-specific-booking-statuses\">Waitlist specific booking statuses<\/h2>\n<div class=\"uk-overflow-auto\">\n<table>\n<thead>\n<tr>\n<th>Status<\/th>\n<th>Meaning<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><span class=\"cevento-docs__term\">Waitlist<\/span><\/td>\n<td>On the waiting list. No spot reserved. Awaiting admin action.<\/td>\n<\/tr>\n<tr>\n<td><span class=\"cevento-docs__term\">Waiting for Payment<\/span><\/td>\n<td>Admin accepted the booking (paid events only). Payment link sent. No spot reserved until payment completes.<\/td>\n<\/tr>\n<tr>\n<td><span class=\"cevento-docs__term\">Confirmed<\/span> \/ <span class=\"cevento-docs__term\">Paid<\/span><\/td>\n<td>Accepted and (for paid events) payment received. Spot is reserved.<\/td>\n<\/tr>\n<tr>\n<td><span class=\"cevento-docs__term\">Cancelled<\/span><\/td>\n<td>The waitlist booking was declined by the administrator.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h2 id=\"waitlist-specific-admin-actions\">Waitlist specific admin actions<\/h2>\n<p>Hover over a booking row in the booking table to reveal the available admin actions:<\/p>\n<div uk-lightbox><a href=\"wp-content\/uploads\/cevento-docs\/en\/003-005-waitlist_actions.jpg\" data-caption=\"Accept \/ Decline Waitlist Bookings as Administrator\"><img decoding=\"async\" src=\"wp-content\/uploads\/cevento-docs\/en\/003-005-waitlist_actions.jpg\" alt=\"Accept \/ Decline Waitlist Bookings as Administrator\"><\/a><\/div>\n<div uk-lightbox><a href=\"wp-content\/uploads\/cevento-docs\/en\/003-005-payment_action.jpg\" data-caption=\"Resend Payment Link as Administrator\"><img decoding=\"async\" src=\"wp-content\/uploads\/cevento-docs\/en\/003-005-payment_action.jpg\" alt=\"Resend Payment Link as Administrator\"><\/a><\/div>\n<h3>Accept<\/h3>\n<ul>\n<li><strong>Free events<\/strong> &mdash; confirms the booking immediately. Status changes to <span class=\"cevento-docs__term\">Confirmed<\/span> and a confirmation email is sent.<\/li>\n<li><strong>Paid events<\/strong> &mdash; moves the booking to <span class=\"cevento-docs__term\">Waiting for Payment<\/span> and sends the payment link email to the user.<\/li>\n<\/ul>\n<h3>Decline<\/h3>\n<p>Cancels the booking and sets the status to <span class=\"cevento-docs__term\">Cancelled<\/span> without sending any emails.<\/p>\n<h3>Resend Payment Link<\/h3>\n<p>Sends a new payment link email to the user. The previously issued link is invalidated immediately, so only the newly sent link remains valid.<\/p>\n<h2 id=\"email-templates\">Email Templates<\/h2>\n<p>Cevento sends automated emails at each progressing stage of the waitlist flow to the user. Subject lines and body text can be customised globally in <span class=\"cevento-docs__term\">Cevento &rarr; Settings &rarr; Emails &rarr; Booking Waitlist<\/span> or in the <span class=\"cevento-docs__term\">Email Templates<\/span> tab of the event editor (per-event overrides).<\/p>\n<div class=\"uk-overflow-auto\">\n<table>\n<thead>\n<tr>\n<th>Template<\/th>\n<th>Sent when<\/th>\n<th>Recipient<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><span class=\"cevento-docs__term\">Waitlist Registration<\/span><\/td>\n<td>A user is put on the waitlist<\/td>\n<td>User<\/td>\n<\/tr>\n<tr>\n<td><span class=\"cevento-docs__term\">Confirmation: User Subject \/ Content<\/span><\/td>\n<td>Admin accepts a waitlist booking on a <strong>free<\/strong> event<\/td>\n<td>User<\/td>\n<\/tr>\n<tr>\n<td><span class=\"cevento-docs__term\">Paid Confirmation: User Subject \/ Content<\/span><\/td>\n<td>Admin accepts a waitlist booking on a <strong>paid<\/strong> event.<\/td>\n<td>User<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<h3>The <code>{payment}<\/code> Placeholder<\/h3>\n<p>In the <span class=\"cevento-docs__term\">Paid Confirmation<\/span> email body, use the placeholder <span class=\"cevento-docs__term\">{payment}<\/span> to insert the payment link as a clickable link. The link label is controlled by the <span class=\"cevento-docs__term\">Waitlist Payment Button Label<\/span> setting under <span class=\"cevento-docs__term\">Cevento &rarr; Settings &rarr; WooCommerce<\/span>.<\/p>\n<p><mark class=\"cevento-docs__notice\">If <span class=\"cevento-docs__term\">{payment}<\/span> is missing from the email body, the user will not receive the payment link and cannot complete their booking. Always include it in the <span class=\"cevento-docs__term\">Paid Confirmation<\/span> template.<\/mark><\/p>\n<h2 id=\"payment-link-security\">Payment Link Security<\/h2>\n<p>Each payment link is:<\/p>\n<ul>\n<li><strong>Reusable<\/strong> &mdash; the same link can be opened again after a checkout window expires. It is not consumed on click.<\/li>\n<li><strong>Exclusive per session<\/strong> &mdash; opening the link reserves a <strong>30-minute checkout window<\/strong> for that session. No other session can start a checkout for the same booking during this window.<\/li>\n<li><strong>Cart-limited<\/strong> &mdash; the booking item in the cart expires after 30 minutes. If the window passes without completed payment, the item is removed from the cart and the link can be used again.<\/li>\n<li><strong>Time-limited<\/strong> &mdash; the link expires automatically after 7 days from issuance.<\/li>\n<li><strong>Invalidated on resend<\/strong> &mdash; using <span class=\"cevento-docs__term\">Resend Payment Link<\/span> revokes the current link before a new one is issued.<\/li>\n<\/ul>\n<p>If two recipients of the same email click the link at the same time, only the first request gets the checkout window. The second request is rejected with a message indicating that a checkout is already in progress. The booking status is additionally re-validated at the cart and checkout stages: if the booking has already been paid or is no longer in <span class=\"cevento-docs__term\">Waiting for Payment<\/span> status, the cart item is removed automatically and the user is getting informed via a descriptive validation error.<\/p>\n\n","protected":false},"featured_media":0,"parent":0,"template":"","meta":{"_acf_changed":false},"thema":[679],"class_list":["post-5053","docs","type-docs","status-publish","hentry","thema-bookings"],"acf":{"excerpt":"All you need to know about enabling overbooking using waitlists.","toc":"<ol class=\"toc\">\n<li><a href=\"#enabling-the-waitlist\"  uk-scroll=\"offset: 120\">Enabling the Waitlist<\/a><\/li>\n<li><a href=\"#how-the-waitlist-works\"  uk-scroll=\"offset: 120\">How the Waitlist Works<\/a><\/li>\n<li><a href=\"#waitlist-specific-booking-statuses\"  uk-scroll=\"offset: 120\">Waitlist specific booking statuses<\/a><\/li>\n<li><a href=\"#waitlist-specific-admin-actions\"  uk-scroll=\"offset: 120\">Waitlist specific admin actions<\/a><\/li>\n<li><a href=\"#email-templates\"  uk-scroll=\"offset: 120\">Email Templates<\/a><\/li>\n<li><a href=\"#payment-link-security\"  uk-scroll=\"offset: 120\">Payment Link Security<\/a><\/li>\n<\/ol>\n"},"_links":{"self":[{"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/docs\/5053","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"wp:attachment":[{"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/media?parent=5053"}],"wp:term":[{"taxonomy":"thema","embeddable":true,"href":"https:\/\/cevento-plugin.com\/en\/wp-json\/wp\/v2\/thema?post=5053"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}