Out of stock badges
An Out of Stock badge appears automatically when a product’s available stock is at or below zero. The plugin re-evaluates this on every render, so the badge appears and disappears as your stock changes.
How the condition works
Section titled “How the condition works”The badge checks the product’s effective stock. Out of stock = stock ≤ 0.
For products with variants, this gets nuanced — a parent product might be “out of stock” because one specific variant is, even though other variants are available. The plugin lets you decide which check to use, separately for detail and listing pages.
Stock checking mode
Section titled “Stock checking mode”Two modes, configurable independently per page type:
- Product only — check the currently rendered product’s own stock. On a detail page showing a specific variant, only that variant counts.
- Include parent — also check the parent product’s stock. Useful on listing pages where the listing shows the parent and you want “out of stock” only when all variants are gone.
You configure the mode on the badge:
- Detail page stock mode — for product detail rendering.
- Listing page stock mode — for category, search, manufacturer and CMS listings.
When to pick which mode
Section titled “When to pick which mode”- Detail = product only, Listing = include parent — typical case. On detail, the badge reflects exactly the variant the customer is looking at. On listing, the badge only shows when the whole product family is sold out.
- Both = product only — when listings always render a specific variant per row.
- Both = include parent — when you want a single source of truth across the store.
When the badge stops showing
Section titled “When the badge stops showing”- Stock goes back above zero (restock, return, manual adjustment).
- The product is hidden or deactivated.
- The badge is deactivated or its rules no longer match.
- Pair with a styling override that reduces the product visibility — e.g. a grey background and reduced opacity on the badge to communicate “sold out”.
- Use priority to decide whether Out of Stock overrides Discount or Top Seller when stock runs low.
- Combine with a corner ribbon (see Angled badges) for a hard-to-miss “Sold out” indicator.