WT Waitlist

FAQ

How does the form appear on the product page?

Automatically — the plugin hooks into the standard WooCommerce action (woocommerce_single_product_summary) for classic themes and into the render_block filter for block themes (FSE). The form is shown only when the product is out of stock.

What if my theme or template does not fire WooCommerce hooks?

Use the shortcode [wt_waitlist product_id="123"] — it works everywhere, from page builders to custom single product templates.

How many emails are sent at once?

Action Scheduler processes batches of 50 subscribers per tick. For a product with 1000 subscribers we queue 20 batches, each processed asynchronously, without blocking the PHP request.

Do emails go through my WP Mail configuration?

Yes. We use wp_mail() — if you have WP Mail SMTP, SendGrid, Amazon SES etc. configured, the mail travels through them. The plugin does not hardcode any provider.

What happens to the data after uninstalling the plugin?

The uninstall.php file drops the tables and deletes the options. Clean. If you deactivate without deleting, the data stays — you can reactivate without losing subscriptions.

GDPR compliance?

The plugin stores anonymized IPs (last octet zeroed), consent timestamp and user agent. It integrates with WordPress Privacy Tools — a customer can request data export or deletion through the standard WordPress flow.

The signup form does not appear on my product page. What now?

First check whether the product is actually out of stock — the form replaces the Add to cart button only when stock is zero (or the variation is unavailable). If the product is out of stock and the form still does not appear, your theme likely uses a custom single-product template that bypasses the standard WooCommerce hooks. Drop the shortcode [wt_waitlist product_id="123"] directly into the product description or template. The shortcode also works inside page builders (Elementor, Bricks, Divi).

Customers submit the form but no notification email arrives.

Open WT Waitlist → Settings and click Send test email to admin. If the test email arrives — wp_mail() works and notifications will be delivered as soon as the product returns to stock (give Action Scheduler 1–2 minutes to process the batch). If the test email does not arrive, the problem is on your mail pipeline, not on the plugin. Install the free WP Mail SMTP plugin and route mail through a transactional provider (SMTP2GO, Brevo, SendGrid, Amazon SES). Shared hosting often blocks mail() silently.

How do I check whether stock notifications are queued?

Open WooCommerce → Status → Scheduled Actions and filter by hook wt_waitlist_*. You will see pending and completed jobs with timestamps. If nothing appears after a stock change, check the System status panel inside WT Waitlist → Settings — it shows whether Action Scheduler is available and how many wt_waitlist_* jobs are pending.

Something is broken and I want to send a support ticket.

Open WT Waitlist → Settings, click Copy diagnostic info and paste the resulting block into your email to support. It includes plugin/WP/WC/PHP versions, theme info, table state, subscription counts, recent email log, Action Scheduler status and a sample of out-of-stock products with their purchasable / backorders state — everything we need to diagnose the issue without going back and forth.

I use Flatsome / Avada / Enfold / Porto and the form does not appear.

Themes with custom product-page templates (Flatsome UX Builder, Avada Builder, Enfold templates, Porto) often replace the standard WooCommerce single-product template, which bypasses the hooks WT Waitlist uses to attach the signup form. As of v1.0.3 we ship multiple compatibility layers, including a wp_footer JS DOM-injection fallback that should handle most of these themes automatically. The plugin also detects these themes and shows a compatibility note inside WT Waitlist → Settings → System status.

If the form still does not show:

• In Flatsome, switch the product template to Default in Flatsome → Theme Options → WooCommerce → Product Page.
• Or place the shortcode [wt_waitlist product_id="123"] directly inside the product description / UX block / Custom HTML block.

My product is marked out of stock but customers can still add it to the cart, and the waitlist form does not appear.

That means the product has backorders enabled (Product → Inventory → Allow backorders). WooCommerce treats it as purchasable even though is_in_stock() returns false — and your customers see the standard “Add to cart” button alongside a backorder notice. WT Waitlist still renders its signup form for such products (so both signup paths coexist), but if the form is missing on a backorder-allowed product, check the Sample out-of-stock products section inside the diagnostic info (button Copy diagnostic info) — it lists is_purchasable / backorders_allowed / subscribers per OOS product so you can see exactly how WooCommerce treats each item.