Magento 2 Product Badges & Labels

Smart conditions (On Sale with an optional minimum discount, New, Low Stock, Out of Stock, Best Seller and Free Shipping), a price range, product types, and attribute conditions built with the same condition builder as catalogue price rules (attributes, attribute set, category, SKU and so on). A product gets the label when it matches every condition you switched on.

Yes. The module has Hyvä layout handles and registers itself for Hyvä's Tailwind build, so the label styles are added to your theme CSS. After installing, rebuild the theme CSS once. Luma and themes based on it load a small CSS file instead.

On category pages, search results, catalogue widgets, related products, up-sells, cross-sells and the recently viewed and compared widgets, and on the product page (main gallery image, under the product name or after the price). Labels are not added to cart, mini cart, wishlist or compare thumbnails.

Labels are assigned by an indexer, so category pages read the stored result with one query per product list instead of evaluating rules for every product. Only rows that changed are written, and only the page cache of products whose labels changed is cleaned.

Yes. Use {discount_percent} or {discount_amount} in the label text. The discount comes from the special price or catalogue price rule and is worked out when the page is rendered, so it matches the price the visitor sees. The percentage is rounded to whole per cent (29.5% shows 30). With CommerceGears Product Compliance (Omnibus) and its setting "Struck-through Price Is the Prior Price", the discount is worked out from the prior price, so the label and the module's percentage show the same number. Other variables are {qty} (quantity in stock), {new_days} (days since the product became new) and {attribute:code} (any product attribute; option labels are resolved).

Yes. For configurable products the label uses the lowest final price of the options against their lowest regular price, as the "As low as" price does. Luma (Magento core) hides the old price of configurable products on listings and shows it on the product page once an option is chosen; Hyvä shows it on listings too.

Yes. Set Label Type to Image and upload a JPG, PNG, GIF or WebP file of up to 2 MB. The label text is then used as alternative text. A transparent PNG or WebP works best.

Labels are shown in priority order (lower numbers first). Stop Further Labels on a label hides labels with a higher priority number on the products that have it, and Maximum Labels per Product in the configuration limits the number of labels per product.

Yes. Each label has store views, customer groups and From/To dates. They are checked when the page is rendered. When a dated label starts or ends, the hourly cron cleans the page cache of its products, so cached pages follow within the hour.

It takes the top N products by ordered quantity in the last X days. Order states listed under Best Seller: Ignore Order States (default canceled,closed) are not counted. Sales are counted over all store views.

The stock conditions and {qty} read the CatalogInventory stock tables. Setups with Multi-Source Inventory have not been tested.

Listing labels are added to images built through Magento's product image factory with known image IDs. If your theme or a slider uses its own image IDs, add them under General > Additional Listing Image IDs (comma-separated, from the theme's etc/view.xml).

Run bin/magento commercegears:product-labels:check <sku>. It lists the labels indexed for the product per store view, with priority and status. Remember that customer groups, dates and the real discount are checked later, when the page is rendered.