Rules & visibility
Assignment tells the plugin which products are eligible for a badge. Visibility tells the plugin whether to actually render it given the current customer, context and time. This page covers the four visibility levers available on every badge.
Sales channels
Section titled “Sales channels”Restrict the badge to specific Shopware sales channels. Leave the field empty to render across all channels.
Typical uses:
- Hide a B2B-specific badge on the consumer storefront.
- Run a country-specific campaign only on the matching storefront.
- A/B-test new badge designs by enabling them on a single channel first.
Shopware rules with AND/OR logic
Section titled “Shopware rules with AND/OR logic”Add Shopware rules (from the standard Rule Builder) to the badge. Rules can check anything Shopware exposes — customer group, cart value, time window, customer attributes, country, etc.
You can attach multiple rules with two combination modes:
- AND — every rule must match for the badge to render.
- OR — at least one rule must match.
Combine AND and OR by chaining rules — e.g. “(B2B customer) AND (cart value > 100 €)” or “(weekend) OR (logged-in customer)”.
The Rule Builder itself is part of Shopware — manage your rules under Catalogues → Rule Builder.
Date scheduling
Section titled “Date scheduling”Two fields on every badge:
- Active from — the badge starts rendering at this date/time.
- Active to — the badge stops rendering after this date/time.
Both fields are optional. Set only Active from to schedule a launch with no end date, or only Active to for a hard expiry. The check runs on every page render — there is no cron / background job involved.
Use cases:
- Promotional badges tied to a sale weekend.
- Holiday-themed labels that auto-disappear after the holiday.
- Pre-launch teasers that go live at midnight on launch day.
Priority
Section titled “Priority”When multiple badges are eligible for the same slot and the Max badges cap is reached, priority decides which badges render. Lower number = higher priority (winning badges render first).
Set priorities deliberately so the most important badges win:
- Time-limited promotions: 1–10
- Discount, Out of Stock: 10–30
- Top Seller, New: 30–60
- Global / always-on: 60+
The Max badges limit is configured in the global configuration, separately for detail pages and listings.
How it all combines
Section titled “How it all combines”For a badge to render on a given product page:
- The badge type’s condition must be true (Standard = on the assignment list; Discount = product is discounted; etc.).
- The badge must be assigned to the product (Standard only) or globally eligible.
- The current sales channel must be in the badge’s allowed list (or the list must be empty).
- The active-from / active-to window must include the current time.
- All Shopware rules must evaluate true under the chosen AND/OR combination.
- The badge must rank within the Max badges limit by priority.
Each step narrows the previous one — visibility is the intersection of all five.
- For time-limited campaigns, always set both Active from and Active to. It is easier than remembering to deactivate the badge manually.
- Prefer rules over per-channel assignments when the same condition recurs across many badges — the rule is reusable, the channel list is not.
- Audit priorities periodically when you add new badges — without thinking about priority, automatic badges (Discount, New, Top Seller) often crowd out promotional ones.