Gatemi Back in Stock FAQ and Troubleshooting

The form does not show on my product

It is only printed on a single product page, and only when all of these are true:

  1. The product is out of stock. A product on backorder counts as in stock in WooCommerce, so it gets no form.
  2. The product is purchasable — published and with a price.
  3. It is not an external/affiliate product.
  4. Full edition: Offer a waitlist on out-of-stock products is on, and no code returns false from the gmbis_show_form filter.

The form is printed on WooCommerce's woocommerce_single_product_summary hook at priority 31. A page builder that draws the product page without that hook will not show it.

Nobody received the back-in-stock email

Check in this order:

  1. Did they confirm? Only confirmed signups are emailed. A signup that never opened its confirmation link stays pending and is sent nothing else.
  2. Did cron run? The email goes out from a sweep scheduled one minute after the stock change (cron hook gmbis_send in the full edition, gmbisf_send in the free edition). WordPress cron runs on page visits, so on a quiet site load a page — or set up a real server cron. With DISABLE_WP_CRON set and no server cron, nothing is ever sent.
  3. Was it still in stock? The sweep reads the stock again. If the product sold out before the sweep ran, nothing is sent and everyone stays on the list for the next restock.
  4. Can the site send mail at all? The plugin uses wp_mail(). Use your SMTP or mail-log plugin to see whether the message left the site.

Only some of my waiting customers were emailed

One sweep emails one batch per product: 50 in the free edition, the How many to email per run setting (1–500) in the full edition. The rest are emailed by the next sweep, and the next sweep is only scheduled by the next stock change for that product. On a long waitlist, raise the batch size in the full edition.

Does it work with page caching?

Yes. The form posts to a WooCommerce AJAX endpoint (?wc-ajax=…), so a cached product page still signs people up. The form carries a nonce; if your cache keeps a product page for longer than a nonce lives (about a day), a shopper may see "Please reload the page and try again." Purge product pages at least daily.

The confirm and unsubscribe links are query arguments on your own site (?gmbis_confirm=… and ?gmbis_unsubscribe=…; gmbisf_… in the free edition). If your cache answers those addresses from cache, the link does nothing — exclude those query arguments from caching.

Does it work with variable products?

The form is on the parent product page and the signup is stored against the parent. When a variation comes back in stock, the plugin sweeps the variation and its parent, so the people waiting on the parent are told. There is no waitlist for one particular variation.

Does it work with the Cart and Checkout blocks and HPOS?

Yes. The plugin does nothing on the cart or the checkout and stores nothing on orders. Both editions declare compatibility with HPOS and the blocks.

Why does a signed-in customer skip the confirmation email?

When the address typed is the address on the customer's own account, WordPress already verified it at registration. Any other address — even from a signed-in customer — gets the confirmation email.

A customer was told about a product and then signed up again

That is expected. A signup that was already emailed goes back to pending (or straight to confirmed for the customer's own account address), so they hear about the next restock too.

Can I see who is on a waitlist?

Full edition: the demand report on WooCommerce → Back in Stock lists the products people are waiting for and how many. Neither edition lists individual addresses on a screen; they are in the wp_gmbis_waitlist table (with your own database prefix).

I am moving from the free edition to the full edition

Install and activate the full edition. Both editions use the same table with the same columns and index, so everyone waiting carries over. While both are active the free edition stands down and says so under its row on the Plugins screen; you can then deactivate and delete it.

Links already emailed by the free edition keep working too. They use gmbisf_confirm and gmbisf_unsubscribe, and the full edition reads those as well as its own, against the same table and the same tokens — so somebody who signed up under the free edition can still confirm or unsubscribe after the upgrade.

What happens when I uninstall?

  • Full edition: deleting the plugin drops the waitlist table and removes gmbis_settings, gmbis_db_version, gmbis_license, the cached update data and both cron events. A waitlist is a list of email addresses held for one purpose; a store no longer running the plugin has no reason to keep it.
  • Free edition: deleting it drops the table only when the full edition has never been configured on the site (no gmbis_settings or gmbis_license option). It always removes gmbisf_db_version and its cron event.

Deactivating either edition removes nothing.

Does the plugin send data anywhere?

The free edition makes no external requests. The full edition contacts gatemi.com only for licence checks and updates, and only once a licence key has been entered.

Shopping Cart
Scroll to Top