Global configuration

The global plugin configuration lives under Settings → Plugins → Product Badges. It defines default styling and placement parameters that every badge inherits from unless it overrides them.

There are five tabs.

General

Enable plugin — master switch. When off, no badges render on the storefront.
Badge position vs. Shopware labels — render the plugin’s badges above or below Shopware’s built-in labels (discount %, top seller, “new”).
Hide default Shopware badges — replace Shopware’s built-in labels entirely with your custom badges. A single toggle that hides the stock discount/topseller/new labels.
“New” badge fallback — when a product has no explicit release date, decide whether the “New” badge should fall back to creation date or be skipped.

Badge defaults

Default styling that every badge inherits from. Anything you set here applies to all badges unless overridden by a slot, placement or the badge itself.

Fields:

Padding, margin, gap
Flex direction
Background color, text color
Font size, line height
Border radius
Backdrop filter (e.g. blur(8px) for a frosted-glass look)
Default icon size

Product page

Settings that apply on the product detail page:

Max badges — how many badges may render. Excess badges are dropped by priority.
Image overlay positioning — top/left/right offsets, z-index, clip path of the overlay container.
Left slot — independent positioning, direction (horizontal/vertical/angled), gap, padding and styling defaults for the left slot on the product image.
Right slot — same configuration for the right slot.

See Image overlay slots for the full reference of slot fields.

Product listing

Mirror of the Product page tab — same fields, but applied to listing pages (category, search, manufacturer, CMS listings):

Max badges (listing-specific)
Image overlay positioning
Left and right slot configuration

The listing values are independent of the detail-page values, so you can render larger badges on detail and tighter ones on listings.

Settings

Admin UX-only toggles:

Default preview visibility — whether the live preview panel in the badge edit form is open by default.

Inheritance order

Every styling property is resolved in this order, from highest to lowest priority:

The badge itself
The placement the badge uses (slot/buy-box-above/buy-box-below/…)
The slot the badge is assigned to (only relevant for image-overlay placements)
The global defaults from this configuration page

Empty values fall through to the next level. Setting a value at the badge level overrides everything else.