WooCommerce Waitlist

With the WooCommerce Waitlist extension, customers of your site can sign up to be notified by email when an Out of Stock product becomes available. As the site owner you can also review which users are on the waiting list for which products, and sort your products by the number of people registered on the waiting list.

WooCommerce Waitlist product screenshot

Out-of-stock product listings with WooCommerce Waitlist enabled

Installation ↑ Back to Top

  1. Unzip and upload the plugin’s folder to your /wp-content/plugins/ directory
  2. Activate the extension through the ‘Plugins’ menu in WordPress
  3. That’s it!

For more information on installing and managing plugins see here

Shop Manager Functionality ↑ Back to Top

Settings Screen

Unregistered users can now join a waitlist without having to login. Users will only need to provide an email address to join each waitlist and an account and welcome email will be automatically created and sent out. This option can be toggled ‘on’ or ‘off’ using an option within the waitlist settings.

Products Listing Screen

WooCommerce Waitlist adds a new column to the Products listing in the WordPress administration area displaying the number of users on the waiting list for a product. This column is sortable in order to enable Shop Managers to quickly find the most ‘sought after’ products in their catalogue.

WooCommerce Waitlist product-listing-screenshot

Edit Product Screen

WooCommerce Waitlist adds a new meta-box to the Edit Product screen for Out-of-stock products only. This meta-box displays all users on the waiting list for the product and provides some simple controls for adding, removing and emailing users.


An example of the meta-box added to the Edit Product page

When editing a waitlist through the Edit Product screen, the product must be saved for changes to take effect,

Automated Emails

When a product is switched from ‘Out-of’stock’ status to ‘In-stock’, WooCommerce Waitlist sends all users on the waiting list an email informing them that the product is back in stock, with a link to the product listing itself for making purchases.

Once this email has been sent, WooCommerce Waitlist removes all users from the waiting list for this product. If the product is subsequently switched back to ‘Out-of-stock’, the waiting list will be empty.

FAQ ↑ Back to Top

Can a customer view all the products they are on a waiting list for?

There is an experimental shortcode [woocommerce_my_waitlist] which will display a table listing all the products that the currently logged in user is waiting for.

Does this work for affiliate products?

No. At the moment stock status has no bearing on the output of an affiliate product listing so these have been left well alone.

Does this work for variable products?

There is a known issue when using WooCommerce Waitlist in conjunction with variable products that prevents the ‘Join Waitlist’ button from being displayed  when the ‘Out of Stock Visibility’ option is set to ON

The only current solution to this problem is to turn this option off:

How do I change the subject / content of emails?

The content of the email and the subject line are both editable via the WooCommerce email system. WooCommerce Waitlist adds a new section to the ‘Emails’ tab of WooCommerce Settings where this can be managed. For more information please see the WooCommerce Documentation.

What if I don’t want users to be automatically emailed when a product is back in stock?

We’ve got you covered. Add the following snippet to your functions.php file in your theme and no email will be sent out and users will remain on the waitlist.

add_filter( 'wcwl_automatic_mailouts_are_disabled', '__return_true' );

What if I want to email users automatically, but don’t want them to be removed from the waitlist?

We’ve got that one too. Add the following snippet to your functions.php file in your theme and users will remain on the waitlist until they purchase that product.

add_filter( 'wcwl_persistent_waitlists_are_disabled', '__return_false' );

Why does the Waitlist only show up for some products?

If you’re using the Advanced Notifications extension make sure you disable the backorder setting.

Extending & Customization ↑ Back to Top

WooCommerce Waitlist comes stuffed with action and filter hooks for your customisation needs. For more information on using hooks in WordPress see here

Action Hooks

  • wcwl_before_add_user_to_waitlist – passes the WC_Product and WP_User objects as parameters
  • wcwl_after_add_user_to_waitlist – passes the WC_Product and WP_User objects as parameters
  • wcwl_before_remove_user_from_waitlist – passes the WC_Product and WP_User objects as parameters
  • wcwl_after_remove_user_from_waitlist – passes the WC_Product and WP_User objects as parameters

Filter Hooks ↑ Back to Top

  • wcwl_update_waitlist_success_message_text
  • wcwl_toggle_waitlist_ambiguous_error_message_text
  • wcwl_leave_waitlist_success_message_text
  • wcwl_join_waitlist_success_message_text
  • wcwl_join_waitlist_message_text
  • wcwl_leave_waitlist_message_text
  • wcwl_grouped_product_message_classes
  • wcwl_grouped_product_message_text
  • wcwl_grouped_product_message_html
  • wcwl_join_waitlist_button_classes
  • wcwl_leave_waitlist_button_classes
  • wcwl_update_waitlist_button_classes
  • wcwl_dummy_waitlist_button_classes
  • wcwl_join_waitlist_submit_button_html
  • wcwl_leave_waitlist_submit_button_html
  • wcwl_dummy_waitlist_submit_button_html
  • wcwl_grouped_waitlist_submit_button_html
  • wcwl_toggle_waitlist_url
  • wcwl_users_must_register_and_login_message_text
  • wcwl_users_must_login_message_text
  • wcwl_grouped_product_style_block_css
  • wcwl_grouped_product_style_block
  • wcwl_waitlist_introduction
  • wcwl_empty_waitlist_introduction
Back to the top