Quickstart

This quickstart walks you to your first active cross-selling rule in just a few minutes. We use a simple example: "Anyone buying a coffee machine gets 10 % off coffee beans."

1

Install and activate the plugin

If you haven't already, install the plugin as described in Installation and turn on Activate App for the desired sales channel in the plugin configuration.

2

Choose slider positions

Stay in the plugin configuration and pick where your customers should see the cross-selling products — for example:

• Show Cross-selling slider in off-canvas basket: Bottom of the off-canvas

• Show Cross-selling slider in basket: Below basket

• Show Cross-selling slider in checkout: Above checkout

Save the configuration.

3

Create your first rule

1. In the administration open the menu entry Cross-selling Checkout (left main menu).

2. Click Create in the top right.

4

Fill in the base data

In the tab Base enter:

Field	Example
Name	Coffee beans to coffee machine
Active	On
Valid from / Valid until	Leave empty or set a campaign window
Discount	10 (percent)
Name of discount in basket	10 % off coffee beans
Show badge on discount products	On

Name is internal-only. Name of discount in basket is the label your customers see for the discount line in their basket.

5

Configure the badge (optional)

In the tab Badge you can change text and colors of the discount badge. Leaving the colors empty means the defaults from the plugin configuration are used. Example:

Field	Example
Badge text	Bundle deal
Badge text color	#ffffff (white)
Badge background color	#d9534f (red)

In the slider and on the product detail page the badge then reads -10 % Bundle deal.

6

Choose the cross-selling type

In the tab Cross-selling settings you choose how the cross-selling products are determined:

• Automatically by assigned Cross Selling from product in basket — the plugin reuses the products you already maintain through the native Shopware cross-selling assignments on your products. Perfect if those are already in place.

• Defined by products / Dynamic product group — you specify yourself which trigger products activate the rule and which cross-selling products are offered. This is what we pick for the example.

7

Define the trigger products

In the tab Trigger products define which products in the basket should fire the rule. Two paths are available:

• Products — pick individual products (in our example: your coffee machines).

• Dynamic product group — pick a group like "All coffee machines". You manage groups under Catalogues → Dynamic product groups.

As soon as one of the trigger products lands in the basket, the rule fires.

8

Define the cross-selling products

In the tab Cross-selling products define what is offered when the rule has fired. Again two paths:

• Manual product list — pick individual products (e. g. a curated selection of beans).

• Dynamic product group — pick a group like "All coffee beans". This way the cross-sellings grow automatically with your assortment.

The slider order follows the sorting set in the plugin configuration. With a manual list you can additionally pin a position per product.

9

Save and test

• Click Save in the top right.

• Open your shop in a private window.

• Add a trigger product (e. g. a coffee machine) to the basket.

• Open the off-canvas basket, the basket page or the checkout — the discounted coffee beans appear with a badge in the slider, and adding one automatically applies the discount on the order line.

What's next

• Admin dashboard — every rule field in detail.

• Dynamic product groups — how to use groups effectively.

• Discount badges — design the badges.

• Storefront integration — where your customers see everything.