Pro Labels User Guide

What it does

Pro Labels puts small badges — New, Sale, Out of Stock and Featured — straight onto your product images, on both category pages and the product page. Each badge appears automatically from the product’s own data: its new-from dates, its special price, its stock level and its category. There’s nothing to tag by hand and nothing to keep in sync — set it up once and every qualifying product is badged.

The labels are drawn with plain HTML and CSS, so they render on any theme — Luma, Hyvä or Lurox — with no JavaScript required.

The four labels

Each label can be turned on or off independently, and each decides on its own whether a given product qualifies:

• New — shown while a product is inside its “Set Product as New from / to” date range (the standard Magento fields on the product).
• Sale — shown when a product has an active special price below its regular price. The label text can include a {discount} placeholder that fills in the saved percentage automatically — e.g. “-25%”.
• Out of Stock — shown when a product is out of stock or has zero quantity.
• Featured — shown for products in a category you nominate, or that have a chosen “featured” attribute switched on. Off by default.

When more than one applies, the badges sit in their configured corners — so a new product that’s also on sale can show both.

Position, shape & colour

Every label is styled independently, so each one can look exactly how you want:

• Position — any of nine anchor points on the image (corners, edges or centre).
• Shape — rounded, rectangle, circle or ribbon.
• Size — small, medium or large.
• Colours — background and text colour per label, so “Sale” can be red, “New” green, and so on.
• Text — the wording of each badge (with {discount} available on the Sale label).

Sensible defaults ship in the box, so a good-looking set of badges appears the moment you switch the module on — tweak from there.

Licensing

Pro Labels is a paid module. It needs an active Pro licence key for your website before any badges appear — installing and enabling it is not enough on its own. This is deliberate: with no valid licence the module stays completely silent and renders nothing, so there’s never a half-working state on your storefront.

In short Enter your Pro licence key at the website scope, then turn the feature on. Until both are done, product images render exactly as they do today.

Configuration

Stores → Configuration → Cabbage Patch Studios → Storefront: Pro Labels.

Every setting is scope-aware (default / website / store), so badges can differ per store.

Setting up & checking it works

1. Enter your Pro licence key for the website (Licensing configuration).
2. Open Storefront: Pro Labels and set Enable Pro Labels to Yes.
3. Leave the New, Sale and Out of Stock labels on (they’re on by default).
4. Pick a product you know is on special, brand-new or out of stock, and open a category page that lists it.
5. You should see the badge overlaid on that product’s image. Turn individual labels off, or restyle them, until it looks right.

Nothing showing? Check the licence key is present for the website and the feature is enabled — with no valid Pro licence the module renders nothing by design.

FAQ

Do I have to tag products by hand? No. Every badge is decided from data the product already has — dates, special price, stock and category.

Will it work on my theme? Yes. Labels are plain HTML and CSS with no JavaScript, so they render on Luma, Hyvä and Lurox alike.

Can a product show more than one badge? Yes — each qualifying label appears in its own configured position.

What happens if my licence lapses? The badges simply stop appearing; your product images return to normal with nothing broken.