Assignment overview
For Standard badges, the assignment decides which products carry the badge. The plugin offers four overlapping ways to assign, plus a quick-assignment UX from the product / category / manufacturer / product stream edit pages.
The automatic badge types (Global, Discount, New, Out of Stock, Top Seller) do not use assignments — their condition decides on the fly.
The four assignment tabs
Section titled “The four assignment tabs”Inside a Standard badge form, four tabs let you assign products:
| Tab | Effect | Best for |
|---|---|---|
| Products | Direct assignment to specific products. | A handful of hand-picked products. |
| Categories | Badge appears on all products in the selected categories (with category inheritance). | Whole sections of the catalogue. |
| Manufacturers | Badge appears on all products of the selected manufacturers. | Brand promotions. |
| Product streams | Badge appears on products matching the dynamic stream’s criteria. | Conditional groups that auto-update. |
A product gets the badge if any of these match — the four tabs are OR-combined.
Quick assignment from the product / category / manufacturer / stream form
Section titled “Quick assignment from the product / category / manufacturer / stream form”You do not have to navigate to the badge module to attach badges. On the edit page of any product, category, manufacturer or product stream, the plugin adds a Badges section where you can pick the badges to attach. The relationship is stored once and reflected in both the badge form and the source entity form.
This is useful when:
- You are working on a product and want to apply an existing badge without leaving the product page.
- You are setting up a category and want to attach a promotional badge inline.
- A merchandiser maintains badges from the product side rather than the badge module.
Category inheritance
Section titled “Category inheritance”When you assign a badge to a category, Shopware’s category inheritance applies — products in child categories also get the badge if they are visible in the parent.
This means a badge assigned to a top-level category (e.g. “Sale”) propagates down all subcategories automatically. If you want narrower control, assign to a more specific subcategory.
Product streams for dynamic groups
Section titled “Product streams for dynamic groups”A product stream is Shopware’s dynamic filter — e.g. “products with stock > 10 and price < 50 €”. Assigning a badge to a stream means the badge appears on whatever products currently match the stream criteria. As products change (price changes, stock fluctuates), the stream membership updates and the badge follows.
This is the recommended approach for dynamic Standard badges that should not be maintained manually.
Combining assignment with visibility rules
Section titled “Combining assignment with visibility rules”Assignment decides which products are eligible. Rules decide whether the badge actually renders given customer / context conditions. See Rules & visibility for:
- Restricting to specific sales channels
- Showing only to logged-in customers / specific customer groups
- Date scheduling (active-from, active-to)
- AND/OR rule logic
A typical setup: assign the badge to a product stream (membership), then add a rule that limits visibility to one sales channel (context).