Troubleshooting

This page collects the issues we see most often. If your badge is misbehaving, walk through the matching section first.

Badge doesn’t appear on the storefront

Check, in order:

Plugin is enabled — Settings → Plugins → Product Badges → General → Enable plugin.
Badge is active — the badge has not been deactivated.
At least one placement is configured (detail page OR listing page). A badge with both placements set to Hidden never renders.
Active-from / active-to window includes the current time.
Sales channel restriction includes the current storefront (or is empty).
Rules all match for the current customer / cart context. Test with no rules attached first to isolate the issue.
Assignment — for Standard badges, the product must be in the assignment (directly, by category, by manufacturer, or by stream).
Cache — clear the Shopware HTTP cache (bin/console cache:clear).

For automatic types, also verify the underlying condition:

Discount — does the product have list price > selling price?
New — is the release date (or creation date, if fallback is on) within the configured window?
Out of Stock — is the effective stock ≤ 0 under the chosen stock-checking mode?
Top Seller — is the Shopware “Top seller” boolean true on the product?

Confirm the plugin is activated under Extensions → My extensions.
Clear the admin cache: bin/console cache:clear.
Hard-reload the admin (Ctrl+Shift+R) so the browser fetches the new bundle.
If you self-build administration, rerun the administration build.
Check that your user role has access to the new ACL keys.

Two badges fight for the same slot

Use priority — lower number wins. Increase the priority gap between badges so the precedence is unambiguous.

If both badges still render, check the Max badges value for the page context. Setting Max badges to 1 makes the slot single-winner — only the highest-priority badge renders.

Styling doesn’t apply

The most common cause is the inheritance order — a value at a more specific level is overriding what you set elsewhere. Walk through:

Is the badge itself overriding the field? Clear it on the badge to fall through.
Is the slot default different from the global default? Compare both.
Is the placement default taking precedence (only relevant for non-overlay placements)?

See Styling overview for the full resolution chain.

Corner ribbon overflows the image

Increase the Max corner offset on the slot, or shorten the badge text — typically 1 to 3 words gives the best ribbon shape. See Angled ribbons.

Shopware’s “New” / “Top Seller” / “Discount” labels still show

You configured a plugin badge of the same type, but Shopware’s plain labels still render alongside it. Toggle Hide default Shopware badges in the global configuration to suppress them. See Hide default Shopware badges.

”New” badge never appears

Make sure the product has a release date set, or
Enable the “New” badge fallback in the global configuration so the plugin falls back to the creation date.

See New badges.

Badge appears on a variant but not on its parent (or vice versa)

For the Out of Stock type, this is controlled by the Stock checking mode. Switch the mode (product only / include parent) separately for detail and listing pages. See Out of stock badges.

For other types, badges follow Shopware’s standard product/variant rendering — make sure the assignment includes the right entity.

Storefront still shows old badge styling after a change

Shopware caches storefront HTML aggressively. After editing a badge:

Clear the HTTP cache: bin/console cache:clear.
If you use a reverse proxy (Varnish / Cloudflare), purge it as well.
Hard-reload the storefront page (Ctrl+Shift+R).

CMS layouts don’t show badges

Badges only render in CMS elements when the layout uses one of the four supported elements (image gallery, buy box, product box, product slider). Custom Twig that bypasses these elements does not get the badge integration — see CMS integration.

Where to look first

Settings → Plugins → Product Badges → General — check Enable plugin and Hide default Shopware badges.
Badge form → Visibility tab — check sales channels, rules, dates.
Badge form → Assignment tabs — for Standard badges, verify the product is actually included.
Live preview — toggle the Preview panel to confirm the badge looks the way you expect.