Low stock badge

The "Only X left" badge alerts customers in the storefront to low available stock and creates urgency — a display Shopware doesn't provide out of the box.

Exact display condition

The badge only appears when all of the following conditions are met at the same time:

1. The "Low stock badge active" setting is turned on
2. The threshold (lowStockThreshold) is greater than 0
3. product.availableStock is set
4. availableStock is greater than 0
5. availableStock is less than or equal to the configured threshold

If any of these conditions is missing, no badge is rendered — there is no fallback text and no alternative display.

availableStock instead of stock

The plugin deliberately evaluates availableStock, not the stock field:

• stock is the physically present stock, regardless of whether open orders already claim part of it.
• availableStock is the stock minus quantities already reserved by open orders — in other words, the stock that can actually still be sold.

Zero stock

If availableStock equals 0, no low stock badge appears — the "greater than 0" condition isn't met. For sold-out products, Shopware's standard sold-out notice takes over; the plugin doesn't intervene there and adds nothing.

Variants

The badge is evaluated per rendered product record. On variant listings (e.g. color or size selection on the tile), the available stock of the displayed record counts — there is no special logic for variant parent products in the low stock badge.

Threshold 0 = badge off

Setting lowStockThreshold to 0 means condition 2 is never met, and the badge stops appearing everywhere — regardless of the "Low stock badge active" toggle. This is the simplest way to temporarily disable the badge store-wide without disabling the setting itself.

An honest note on effectiveness

An "Only X left" badge only creates credible urgency if your stock data is accurate. If stock isn't maintained cleanly or your ERP integration is delayed, the badge can either suggest false scarcity or — the opposite case — fail to appear on genuinely scarce products. Check the threshold regularly against your real stock situation, see Configuration.