--- title: "Test your setup" description: "Walk through a full test cycle before you rely on Back in Stock alerts." url: https://help.stoqapp.com/back-in-stock/test-back-in-stock-alerts/ product: "Back in Stock" section: "Get started" last_updated: 2026-10-27 --- # Test your setup > Walk through a full test cycle before you rely on Back in Stock alerts. Back in Stock alerts run on your live, published storefront, not inside the STOQ admin. Before you trust the feature to catch every out-of-stock customer, walk through one full cycle yourself: see the button, sign up, restock the product, and confirm the alert arrives. > **Note** > > The preview panel in **Back in Stock alerts > Settings > Signup widget** shows a mock button for styling only. It doesn't reflect real inventory, so check the actual storefront to know it works. ## Before you begin | Requirement | Where to check | |---|---| | Back in Stock alerts turned on | **Back in Stock alerts > Settings > Signup widget** | | App embed active in your theme | A **Turn on app embed** badge next to the STOQ page title prompts you to enable it if it isn't | | A test product that's actually out of stock (or set to always show the button) | **Back in Stock alerts > Products** tab | | At least one notification channel enabled (email and/or SMS) | **Back in Stock alerts > Settings > Notifications** | | A minimum restock quantity set (alerts only send once inventory restocked meets or exceeds this) | **Back in Stock alerts > Settings > Notifications** | | No storefront password, or **Send alerts while your store is password protected** ticked (alerts are held while a password is on) | **Back in Stock alerts > Settings > Delivery settings**, in the **Notify when restocked** card | > **Warning** > > The "Notify me" button only renders if STOQ's theme app extension (app embed) is active on the theme you're viewing, your live theme, or a draft theme you're previewing with the embed enabled. If it isn't, the button won't appear no matter how the widget is configured. ## What customers will see When a signed-up customer's product restocks, they receive the email and/or SMS alert you've designed in **Settings > Notifications**, using the contact details they submitted through the "Notify me" form. They do not need to return to your store on their own: the alert links them back to the product. ## Set it up 1. **Pick or prepare a test product** In **Back in Stock alerts > Products**, find a product/variant and check its **Button visibility** column. By default it's set to **When out of stock**, meaning the button only shows automatically once Shopify inventory hits zero for that variant. For testing, either: - Use a product/variant that's genuinely out of stock, or - Temporarily set **Button visibility** to **Always show** so you can see and test the button regardless of stock. Note that setting a variant to **Never show** hides the button even if it's out of stock, so make sure your test product isn't set that way. [Image: The Button visibility column on the Back in stock alerts Products tab](https://help.stoqapp.com/images/general/visibility.png) 2. **Visit the live storefront** 1. Open your **published** theme in a real browser tab (not the Shopify admin preview). 2. Go to the test product's page. 3. Confirm the "Notify me" button appears where you expect (this also confirms the app embed is active and your button styling from **Settings > Signup widget** looks right). [Image: The Notify me button on the test product page on the live storefront](https://help.stoqapp.com/images/general/notifyme.png) 3. **Submit a test signup** 1. Click the button. 2. Submit the signup form using an email address (and phone number, if SMS is enabled) that you control. Use a real inbox, not a placeholder like test@example.com or a disposable inbox like mailinator.com. STOQ blocks those addresses and the form shows its email error. 3. Confirm the form submits without an error and shows its success state. [Image: The back in stock signup form popup with an email address entered](https://help.stoqapp.com/images/general/signup.png) 4. **Confirm the signup was captured** In STOQ, go to **Reports > Back in Stock > Current waitlist**. Your test signup should appear here, linked to the product/variant you tested. If you don't see it, the signup didn't reach STOQ, so recheck the app embed and button setup before continuing. [Image: The test signup listed in Reports, Back in stock, Current waitlist](https://help.stoqapp.com/images/general/currentwait.png) 5. **Restock the product** In Shopify Admin, raise the tested variant's inventory so it meets all of these, then Shopify notifies STOQ of the change automatically: - At or above your **Minimum restock quantity**, set in **Back in Stock alerts > Settings tab > Notifications**. - At a location included in your delivery settings, if location filtering applies to your plan. - On a product that is active and published to the Online Store sales channel. [Image: The test product in the Shopify admin Products list, showing 0 in stock](https://help.stoqapp.com/images/general/productsadmin.png) 6. **Check the alert arrives** Give it a few minutes, then check the inbox (and/or phone) you signed up with. If batching is enabled in **Settings > Delivery settings**, the alert may not send immediately. [Image: The Inventory section in Shopify admin, available quantity set from 0 to 5](https://help.stoqapp.com/images/general/inv.png) [Image: The back in stock alert email received in the test inbox](https://help.stoqapp.com/images/general/alertlive.png) 7. **Verify in STOQ** Go to **Reports > Back in Stock > Notifications sent** and confirm your test notification is listed. This is the definitive record that STOQ attempted delivery, separate from whether the email/SMS physically landed in your inbox. [Image: The test notification listed in Reports, Back in stock, Notifications sent](https://help.stoqapp.com/images/general/sent.png) ## Check your setup - **Reports > Back in Stock > Current waitlist**: shows signups still waiting for a restock. - **Reports > Back in Stock > Notifications sent**: shows signups STOQ has already notified. ## Troubleshooting ### Nothing shows up in STOQ after a storefront signup Confirm the following. 1. The app embed is active for your published theme (STOQ shows a **Turn on app embed** badge next to the page title if it's off). 2. Back in Stock alerts is turned on in **Settings -> Signup widget**. 3. You're testing the published theme, not a draft. ### You restocked the product but no alert was sent A signup that stays in the waitlist after a restock is usually caused by one of these. 1. The new inventory quantity is below your **Minimum restock quantity**. 2. The restock happened at a location not included in your delivery settings (on plans with location filtering). 3. The product isn't active and published to the Online Store channel. 4. Your storefront is password protected. STOQ holds alerts until you remove the password, or until you tick **Send alerts while your store is password protected** in **Settings > Delivery settings** ([details](https://help.stoqapp.com/back-in-stock/back-in-stock-password-protected-store/)). If batching is enabled in **Settings > Delivery settings**, the alert waits for the next batch window instead of sending immediately. ### The button doesn't appear even though the product is out of stock Check the following. 1. The product's **Button visibility** setting under **Back in Stock alerts -> Products** (it may be set to **Never show**). 2. The app embed is active. 3. You're viewing the published theme. ### The signup form shows an email error for your test address STOQ blocks known test, placeholder and disposable addresses on every store, so they never reach your waitlist. This includes test@example.com, any address at example.com or test.com, and disposable inboxes like yopmail.com and mailinator.com. The form shows the same error it shows for an invalid email. Sign up again with an email you actually receive mail at. If you also entered a phone number, the SMS signup still goes through and only the email is dropped. ## FAQ ### Can I trigger a test alert without actually changing inventory? Yes. In **Reports > Back in Stock > Current waitlist**, you can select your test signup and send its notification manually, without waiting for a real inventory change. Your restock email template also has a separate "Send test email" option in the template editor, which sends a sample using placeholder data rather than testing your live signup. ### Does testing use up my plan's alert limit? Yes. A test signup and its resulting alert count the same as any real customer notification toward your plan's monthly limit. ### Can I resend an alert to a customer who already signed up? Yes. In **Reports > Back in Stock > Notifications sent**, each notification has a **Re-send** action, and you can re-send to multiple selected notifications at once. ### Do I need to test SMS separately from email? Yes, email and SMS are configured and sent independently. If both channels are enabled, submit the test signup with a phone number as well as an email so you can confirm both deliver. ## Related guides - [Set up alerts](https://help.stoqapp.com/back-in-stock/set-up-back-in-stock-alerts/): The full setup walkthrough, start to finish. - [Design the Notify me button](https://help.stoqapp.com/back-in-stock/design-notify-me-button/): Style and position the storefront button. - [Choose which products show the button](https://help.stoqapp.com/back-in-stock/notify-me-product-eligibility/): Control which products show the button and when. - [Customize the back in stock email notification](https://help.stoqapp.com/back-in-stock/back-in-stock-email-alert/): Configure and preview the restock email template.