Placement overview
Every badge is configured for two contexts independently: detail pages and listing pages. The placement options differ slightly between the two because the surrounding template is different.
Available placements
Section titled “Available placements”Detail page (product detail view)
Section titled “Detail page (product detail view)”| Placement | Where it renders |
|---|---|
| Image overlay | Directly on the product image, in one of two slots — Left or Right. See Image overlay slots. |
| Above buy box | Just above the buy-box / add-to-cart area on the product detail page. |
| Below buy box | Just below the buy-box area. |
| Hidden | Not rendered on detail pages (the badge will only appear on listings if configured there). |
Listing page (category / search / CMS listing)
Section titled “Listing page (category / search / CMS listing)”| Placement | Where it renders |
|---|---|
| Image overlay | Directly on the product card image, in the Left or Right slot. |
| Above product info | Above the product name and price in the listing card. |
| Below product info | Below the product name and price. |
| Hidden | Not rendered on listings. |
At least one of the two contexts must have a non-hidden placement, otherwise the badge will never appear.
Independence of the two contexts
Section titled “Independence of the two contexts”The detail-page placement and the listing-page placement are configured separately on every badge. That lets you, for example:
- Show the badge as a corner ribbon on listings but as a regular image overlay on detail pages.
- Show the badge on detail only (full information) and skip listings.
- Use different slots (left on listings, right on detail) without affecting the other.
Image overlay slots: left and right
Section titled “Image overlay slots: left and right”Inside the image overlay placement there are two independent slots — Left and Right. Each slot has its own positioning, direction (horizontal / vertical / angled), spacing and styling defaults. A badge picks one of the two slots per page type.
See Image overlay slots for the full reference.
Angled (ribbon) badges
Section titled “Angled (ribbon) badges”Any image-overlay slot can be set to Angled (45°) direction, turning every badge in that slot into a corner ribbon. You can also override the angled behaviour per badge.
See Angled ribbons.
Hiding default Shopware badges
Section titled “Hiding default Shopware badges”Shopware ships with its own labels (discount %, top seller, “new”). To replace them with the plugin’s badges, toggle Hide default Shopware badges in the global configuration.
See Hide default Shopware badges.