How to show a low-stock alert

A low stock alert in Bundlex Bundles shows a short message like "Only 3 left" beside an available variant when its inventory reaches your threshold. The app uses the inventory quantity returned by Shopify for that variant. The message helps shoppers understand availability; it does not reserve stock.

Before you start

The low stock alert appears inside the per-offer variant selector, so on quantity break and BOGO offers it only works when the Variant selector section in the Add-ons tab is turned on for the bundle. If that setting is off, customers use Shopify's default variant picker and the alert has no row to attach to. Product bundle offers always show their own variant rows, so the alert can appear there either way. See Show a variant selector per offer for how to enable it.

• The variant must have inventory tracking enabled in Shopify.
• The variant must not be set to keep selling when out of stock (oversell off).
• The variant must be available for sale, and Shopify must provide its inventory quantity.
• The alert shows only when available stock is at or below your threshold.

Enable the low stock alert

1. Open the bundle you want to edit.
2. Open the Advanced tab.
3. Under Offers and stock, turn on Show low stock alert.
4. The Message and Threshold fields appear once the alert is enabled.

Set the threshold

The Threshold field controls how low stock has to drop before the alert shows. The alert appears when a variant's available quantity is at or below this number. The default is 5, and you can enter any whole number from 1 to 1000.

With a threshold of 5, a variant with 5, 4, 3, 2, or 1 unit left will show the alert. A variant with 6 or more units will not.

Write the message

The Message field is the text shown on the variant row. It supports one variable, {{stock}}, which is replaced with the quantity Shopify returned for the variant. The default message is Only {{stock}} left, which renders as "Only 3 left" when that quantity is three.

You can write your own copy and place {{stock}} anywhere in it, for example Hurry, only {{stock}} in stock!. The message is required to include {{stock}}, so if you remove it the bundle will not save until you add it back. Keep the message to 200 characters or fewer.

Choose the color

The alert color is set in the Style tab, under Widget style > Container, in Alert color. It defaults to a red tone so the message reads as urgent, but you can pick any color to match your theme.

How it behaves on the storefront

• The message renders per variant row inside the offer's variant selector, so different variants can show different counts (or none) at the same time.
• The widget loads inventory information from Shopify. Do not assume an already open page continuously reflects sales in other sessions. Reload the product page when checking an inventory change.
• Variants that are untracked, set to keep selling when out of stock, or above the threshold show no alert.

Preview it

To see the alert in the editor preview, select a variant that is low in stock. On quantity break and BOGO offers, the Variant selector section must be on for the alert to appear at all.

Troubleshooting

• No alert shows. Confirm the Variant selector section is on, the variant has inventory tracking enabled, and its stock is at or below your threshold.
• The bundle will not save. The message must contain {{stock}}. If you deleted the variable, add it back to the message field and save again.
• The alert never appears even at low stock. Check that the variant is not set to keep selling when sold out, since oversell variants are excluded.