LabelsPro

LabelsPro puts the right message on the right product automatically. Build a badge or a banner once, say which products should carry it — by attribute, by category, by SKU, or a combination — and it appears wherever that product is shown, on the listing and on the product page. It renders on a standard Luma storefront and on a headless (Astro) storefront from the same configuration.

Install

Install LabelsPro with Composer using your AgenticEcom licence key (find it on your My Licences page — one key unlocks every module you own):

# 1. Register the AgenticEcom repository (once per store)
composer config repositories.agenticecom composer https://repo.agenticecom.net
composer config --global --auth http-basic.repo.agenticecom.net <YOUR-LICENCE-KEY> x

# 2. Require this module
composer require agenticecom/module-labelspro

# 3. Apply it
php bin/magento setup:upgrade && php bin/magento setup:di:compile && php bin/magento cache:flush

Have the whole platform?

Install every module in one command with composer require agenticecom/suite — see Install the complete suite.

Compatibility

Magento

Open Source 2.4.9 GA (and later 2.4.x).

PHP

Tested on 8.3, 8.4 and 8.5.

Storefront

Standard Luma and headless (Astro) via the synced product data.

Dependencies

None — no third-party libraries.

Badges and banners

A badge is small and sits on the product image — the sale ribbon, “New in”, a low-stock warning. A banner is a full-width strip under the price, for a sentence rather than a word: “In stock — available next working day”.

Both are built in the same designer and both follow the same targeting rules. The grid shows a live preview of every label exactly as it will render, so a label is approved before it reaches a product page.

Placement

Four corners of the image for badges, or under the price for a banner.

Presets

Pill, ribbon, dot and more — the dot is deliberately quiet, for a status rather than a shout.

Colour roles

Accent, success, warning, info and danger, taken from the store’s palette so labels match the theme rather than fighting it.

Sizes

Small, medium and large, in fixed pixel sizes so a label reads the same on every theme.

Why colour roles, not colour pickers

The built-in roles are chosen to clear WCAG AA contrast against their own text. A free colour picker is still there when a brand needs one, but the roles mean the default is legible without anyone having to check.

Deciding which products get a label

Conditions match on:

• any product attribute — brand, material, a custom flag, anything in your catalogue;
• categories — and a category condition includes everything beneath it, so you name the parent rather than listing every child;
• SKU — one product, or a list of them.

Combine them with ALL (every condition must match) or ANY (one is enough). That covers the two things merchants actually ask for: a label across a whole range, and a label on one flagship product.

1. Go to Catalog → LabelsPro → Labels & Banners and click Create Label / Banner.

2. Choose the family — badge or banner — and where it sits.

3. Design it: preset, colour role, size, an optional icon, and the text.

4. Add conditions, and set the mode to ALL or ANY.

5. Set the priority if this label competes with others (see below), choose the store views and customer groups, and save.

When several labels match

Every label has a priority. Where more than one applies to the same product and the same placement, the higher priority wins the spot; a label can also be set to hide lower-priority labels entirely, so a clearance ribbon can suppress the “New in” badge rather than stacking with it.

Labels that retire themselves

A label can be given a show window — the dates it starts and stops appearing. A Black Friday badge goes live on the day and retires on its own, with nobody remembering to switch it off at midnight. Labels outside their window are simply not rendered.

There is also an out-of-stock behaviour per label, so a “Next working day dispatch” banner disappears rather than making a promise the warehouse cannot keep.

A label that lies costs more than no label

The scheduling and out-of-stock rules exist for one reason: a promotion badge left up after the promotion ended, or a dispatch promise on an out-of-stock product, is worse than showing nothing. Set the window when you create the label, not later.

The storefront

Listing

Each card carries only the labels that product actually qualifies for, in priority order.

Product page

The badge sits with the gallery and the banner sits under the price, where a shopper reads it while deciding rather than after.

Headless (Astro)

On a headless storefront the labels ride along with the product data itself, so a card or a product page renders them without any extra call. Two switches control where they are allowed to appear — badges on listings, banners on listings — and a third publishes label data into the product’s structured data.

Settings

Stores → Configuration → AgenticEcom → LabelsPro

Setting	What it does
Enable LabelsPro	Master switch.
Show badges on listings	Whether badges render on category and search listings as well as product pages.
Show banners on listings	Banners are usually product-page only; turn this on to show them on cards too.
Structured data	Publish label information in the product’s structured data.

Changing a label's wording on a headless store

Label text travels with the product data, so after editing a label the storefront needs a product data sync to pick it up. From version 1.0.1 saving a label clears the caches that hold the previous wording, so the next sync sends the new text rather than the old.

Frequently asked questions

Can I put a label on just one product? Yes — a SKU condition targets exactly one product, or a list of them.

Can I label a whole category? Yes, and a category condition covers everything beneath it, so you name the parent rather than listing every child.

What happens when two labels want the same spot? The higher priority wins. A label can also be set to hide lower-priority ones so they do not stack.

Do labels work on a headless storefront? Yes. They travel with the product data, so cards and product pages render them with no extra call.

Will a promotion badge disappear on its own? Yes, if you give it a show window. It appears on the start date and stops on the end date without anyone switching it off.