Back In Stock Notifier

Back In Stock Notifier adds a customizable Notify Me form to your WooCommerce store. Shoppers can request a one-time email for a sold-out simple product or a specific variation, such as a blue shirt in medium. Restocking another size does not trigger that alert.

Before you start: Activate WooCommerce and BricksUltimate 2.5 or later. Enable Back in Stock under Bricks → BricksUltimate → Woo Elements, then save your changes.

Set Up the Element


  1. Open your WooCommerce single-product template in Bricks and add (BU) Back in Stock.
  2. Place the element beside or below the Add to Cart element, outside the Add to Cart form. For variable products, keep both elements in the same product section so the notifier can follow the selected variation.
  3. Choose a Display mode, edit the form text, and style the element to match your template.
  4. Save the template and open a sold-out product on the storefront. For a variable product, select all required attributes, such as size and color.

On a sold-out simple product, the form appears automatically. On a variable product, it appears when the shopper selects an eligible sold-out variation and hides when the shopper selects an in-stock variation or clears their selection. Products and variations must be published, priced, and available to the public. If WooCommerce hides sold-out variations, shoppers cannot select them in the normal variation form.

Element Options


  • Display mode: Choose Embedded form to show the signup fields immediately, or Expandable Notify Me button to reveal the fields when a shopper opens the trigger.
  • Hide Add to Cart: Hides the purchase form for an eligible sold-out simple product. For a sold-out variation, it hides the purchase controls while keeping the variation selectors available. Selecting an in-stock variation restores the controls.
  • Form text: Customize the heading, email label and placeholder, submit button, expandable trigger, and signup notice.
  • Layout: Choose stacked or inline fields and adjust the field gap.
  • Styling: Use the element's Heading, Email Label, Email Field, Button, Signup Notice, and Response Message controls for typography, background, border, and padding. The Button controls also include a hover background.

Guests and logged-in shoppers can enter an email address. An email can have one active alert per product or variation. A successful submission replaces the form with a confirmation message. If the request fails, the form keeps the entered address so the shopper can correct the issue or try again.

Product Cards and AJAX Quick View

To add alerts to a shop or archive grid, place the element inside each product card in a Bricks product query loop. Use Expandable Notify Me button for compact cards. If a variable-product card has no matching variation form, the expandable element can offer its own picker of eligible sold-out variations.

For native Bricks Quick View, enable WooCommerce Quick View and Fetch content via AJAX in the popup settings. Put the notifier and Add to Cart in the popup template, and pass the current product as the popup's post context. Keep the notifier outside the cart form.

The Bricks condition Product accepts stock alerts can control other elements in a simple-product or variation context. On a variable product page, use the notifier's built-in visibility so it can react when a shopper changes their selection.

Manage Subscriptions


Go to WooCommerce → Back in Stock. The page includes four tabs.

  • Subscriptions: Filter by product or variation ID, email, or status. Filtering by a variable parent ID includes its variations. The list shows the request date, latest send attempt, and any recorded mail error. Export CSV exports the matching records.
  • Demand & Sales: See which products or variations have the most pending requests and when the oldest request was made. Sales reporting counts the first qualifying order for the exact alerted item within seven days of the tracked alert. Revenue uses the matching item total after discounts and before tax, grouped by currency.
  • Email: Edit the restock notification template, send a test email, and find sender and SMTP guidance.
  • Settings: Configure signup confirmation, stock thresholds, product overrides, and sending waves.

Bulk Actions

On the Subscriptions tab, filter the list if needed, then check the rows you want to update. The header checkbox selects only the subscriptions on the current page. Choose an option from Bulk actions and click Apply.

  • Cancel subscriptions: Stops future restock alerts for selected pending, queued, or unverified subscriptions and keeps their records. An email that is already being sent cannot be recalled.
  • Retry failed notifications: Requeues selected restock notifications that have exhausted their automatic attempts, provided the exact product or variation meets its stock threshold. Already queued or sent alerts are skipped.
  • Delete permanently: Removes the selected records and any associated reporting history. Review the selected count and confirm on the next screen. Use cancellation when you need to keep the record.

After the action, the list keeps your filters and shows how many subscriptions changed or were skipped.

Subscription Statuses

  • Pending: The request is active and waiting for stock or the next eligible send.
  • Unverified: The shopper still needs to confirm their email address.
  • Queued: A background send or retry has been scheduled.
  • Accepted by mailer: WooCommerce's mailer reported success. Check your mail provider's logs to confirm delivery.
  • Failed: A send failed. Restock sends retry automatically up to three total attempts. Use Retry after the final failed restock attempt once mail is working and the item meets its stock threshold. A shopper can submit the form again after a failed verification email.
  • Cancelled: The request is closed and will not receive a restock alert.

Logged-in customers can view and cancel their active requests under My Account → Stock Alerts. This is a WooCommerce My Account endpoint with the slug stock-alerts, so you do not need to create a separate WordPress page. For a custom account layout, place [bu_stock_alerts] in a Shortcode element. When email confirmation is enabled, the verification email also gives guests a cancellation link.

Configure Signup and Delivery


Open WooCommerce → Back in Stock → Settings to configure these options.

  • Require email confirmation: Sends a verification link when the shopper signs up. The link expires after 24 hours. With confirmation turned off, a successful signup starts waiting for stock immediately.
  • Default minimum stock: Sets the minimum available quantity for inventory-managed products. For products without quantity tracking, the WooCommerce stock status determines eligibility to send.
  • Product stock override: Enter a product or variation ID and save its minimum quantity. A variation override takes precedence over the parent product setting. Enter 0 to inherit the parent or global threshold.
  • Recipients per wave: Limit how many subscribers receive an alert in each wave. Set 0 for normal background batches. Choose the Minutes between waves to give each group time to shop before the next send. The queue rechecks stock and does not reserve inventory for recipients.

BricksUltimate listens for WooCommerce stock updates and queues restock emails through Action Scheduler. Update the exact variation that shoppers subscribed to, or update the parent product if it manages that variation's stock. A restock alert is sent once per successful subscription.

Customize and Test Emails


  1. Open WooCommerce → Back in Stock → Email. Under Restock email template, edit the Subject, Heading, rich-text Message content, and Button text. The product details and button link are added automatically. Click Save email template before sending a test.
  2. In WooCommerce → Settings → Emails, set the From name and a From address authorized by your mail provider. Back in Stock uses WooCommerce's mail sending method and falls back to the WordPress admin email when the WooCommerce From address is invalid.
  3. Back on the Email tab, enter a product or variation ID under Test email and click Send test email. The saved template goes to the email address of the admin account currently signed in. Use a variation ID to preview variation details. A test does not notify subscribers.
  4. Confirm the test arrives. Then submit Notify Me on a sold-out product, confirm the request if required, and update that exact item to In stock at or above its minimum quantity. Check the subscription status and your inbox.

Template Placeholders

Use these placeholders in the subject, heading, message, or button text:

  • {product} – the product name.
  • {variation} – the selected variation's attributes, such as size and color. This is empty for a simple product.
  • {site_name} – your WordPress site name.

The template applies to restock notifications. The signup verification email is separate and is sent only when Require email confirmation is enabled.

Email delivery: Local development sites can accept outgoing messages without delivering them. If test messages do not arrive, configure an authenticated SMTP provider for WordPress and check the provider's mail logs and your spam folder.

Troubleshooting


  • The form is missing: Check that the element and template are active, the product is published and priced, and the item is sold out. For a variable product, confirm all attributes are selected, the sold-out variation is visible, and the notifier shares the variation form's product context.
  • The form reports an error: Refresh the product page to reload its security token, then retry. If the generic error persists, inspect the admin-ajax.php request for bu_back_in_stock_subscribe in your browser's Network tab.
  • A subscription stays pending: Check the exact item's stock status, minimum quantity, and wave settings. If it is eligible, look for bu_back_in_stock_notify under WooCommerce → Status → Scheduled Actions and confirm WordPress scheduled tasks can run.
  • The mailer accepted the message but nothing arrived: Check the spam folder, SMTP logs, and sender authorization. A new test email helps separate delivery issues from stock or scheduling issues.