Upsell & Cross-Sell¶
Rule-based upsell & cross-sell system for Shopware 6. Define rules in the admin such as "If product X is in the cart → recommend product Y with an optional discount" – without any coding. Recommendations appear automatically as a product box on the product detail page (upsell) and in the cart (cross-sell).
Highlights
- 🎯 Rule-based recommendations – freely combinable conditions
- 🛒 Upsell on the product page & cross-sell in the cart
- 🏷️ Optional discount badge (percentage or absolute)
- ⏱️ Validity window & priority per rule
- ⚙️ Configurable – max recommendations & hide products already in the cart
❓ FAQ¶
Do I need to code the rules?
No. All rules are created and managed entirely in the admin area under Marketing > Upsell & Cross-Sell.
Where are the recommendations shown?
Upsell rules appear on the product detail page, cross-sell rules on the cart page – each as a product box.
How are multiple conditions combined?
Within a rule, all conditions must match (AND logic). For OR logic, create several rules.
What happens if several rules recommend the same product?
The product is shown only once. The rule with the higher priority wins.
Is the discount automatically deducted in the cart?
In version 1.0.0 the discount is shown as an informational badge on the recommendation. Automatic application of the discount to the cart price is planned for a future release.
🔧 Installation¶
- Prerequisite: CNK Foundation Plugin
- Installation via Shopware Store or ZIP
- Activation in the Plugin Manager
- Rule management visible under Marketing > Upsell & Cross-Sell
🧩 Manage Rules¶
In the admin area open Marketing > Upsell & Cross-Sell and create a new rule. Each rule consists of general settings and one or more condition/action rows.
General settings¶
| Field | Description |
|---|---|
| Name | Internal name of the rule |
| Type | Upsell (product page) or Cross-sell (cart) |
| Priority | Higher priority wins when the same product is recommended by several rules |
| Active | Enable/disable the rule |
| Valid from / to | Optional period during which the rule applies |
Conditions & actions¶
Each row defines one condition and its action (the product to recommend). The rule applies only when all row conditions match.
Condition types¶
| Condition | Meaning |
|---|---|
| Product in context | The selected product is in the cart or currently being viewed |
| Category in context | A product of the selected category is in the context |
| Cart total is at least | The cart value reaches the given amount (cross-sell only) |
| Customer group | The customer belongs to the selected customer group |
Action types¶
| Action | Meaning |
|---|---|
| Recommend product | The selected product is recommended without a discount |
| Recommend + discount (%) | Recommendation with a percentage discount badge |
| Recommend + discount (amount) | Recommendation with an absolute discount badge |
⚙️ Configuration¶
Found under Settings > Plugins > Upsell & Cross-Sell:
- Maximum number of recommendations per box (1–5, default 3)
- Hide products already in the cart (default: on)
🖥️ Example¶
Goal: whoever views a camera should see the matching lens as an upsell with a 10% discount badge.
- Marketing > Upsell & Cross-Sell > Add rule
- Type:
Upsell, Priority:10, Active: on - Condition row:
- Condition: Product in context → Camera
- Action: Recommend + discount (%) → Lens, Discount value:
10
- Save – the recommendation appears on the camera's product page.