> For the complete documentation index, see [llms.txt](https://docs.premsoft.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.premsoft.de/en/plugins/cross-selling-for-cart-and-checkout/quickstart.md).

# 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."**

{% stepper %}
{% step %}

## Install and activate the plugin

If you haven't already, install the plugin as described in [Installation](/en/plugins/cross-selling-for-cart-and-checkout/installation.md) and turn on **Activate App** for the desired sales channel in the plugin configuration.
{% endstep %}

{% step %}

## 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.
{% endstep %}

{% step %}

## 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.
   {% endstep %}

{% step %}

## 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.
{% endstep %}

{% step %}

## 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`.
{% endstep %}

{% step %}

## 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.
  {% endstep %}

{% step %}

## 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.
{% endstep %}

{% step %}

## 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.
{% endstep %}

{% step %}

## 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.
  {% endstep %}
  {% endstepper %}

## What's next

* [Admin dashboard](/en/plugins/cross-selling-for-cart-and-checkout/dashboard.md) — every rule field in detail.
* [Dynamic product groups](/en/plugins/cross-selling-for-cart-and-checkout/dynamic-product-groups.md) — how to use groups effectively.
* [Discount badges](/en/plugins/cross-selling-for-cart-and-checkout/discount-badges.md) — design the badges.
* [Storefront integration](/en/plugins/cross-selling-for-cart-and-checkout/storefront-integration.md) — where your customers see everything.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.premsoft.de/en/plugins/cross-selling-for-cart-and-checkout/quickstart.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.