> 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/configuration.md).

# Configuration

The plugin configuration lives at **Extensions → My extensions → Cross-Selling for Basket and Checkout → … → Configuration**. Use the selector at the top to choose the sales channel the settings apply to.

{% hint style="info" %}
Every setting works **per sales channel**. That way your B2C shop can use different slider positions than your B2B shop.
{% endhint %}

## General properties

### Activate App

The master switch per sales channel. When off, neither sliders nor discounts appear — regardless of how many active rules exist. That way you can pause the whole plugin temporarily in one shop without losing your rules.

### Default badge colors

| Field                                       | Meaning                                                                                               |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Default discount badge background color** | Background color for badges where the rule itself has no explicit color. Defaults to `#ff0000` (red). |
| **Default discount badge text color**       | Text color for badges where the rule itself has no explicit color. Defaults to `#ffffff` (white).     |

These values act as a **fallback** — colors set in the rule itself override them.

### Max. number products in cross-selling slider

Caps how many products the slider may show. Default: `10`.

{% hint style="info" %}
Only raise this if you actually have many relevant cross-sellings — overly long sliders distract customers. Values between 6 and 12 work best in practice.
{% endhint %}

### Product sorting in slider

Decides the order in which products appear. Available:

* **Name** (alphabetical)
* **Discount ascending / descending**
* **Price ascending / descending**
* **Release date ascending / descending**

For manually picked cross-selling products you can additionally override the order via the position field in the rule.

### Always show the "Add to shopping cart" button

When on, the **"Add to cart" button** is always shown in the slider — even for parent variant products. By default, clicking those products takes the customer to the detail page (so they can pick a variant). With this option on the button appears immediately, which is the fastest path to the basket for single-variant products.

## Slider positions

### Show cross-selling slider in off-canvas basket

| Value                        | Meaning                                                                    |
| ---------------------------- | -------------------------------------------------------------------------- |
| **No**                       | No slider in the off-canvas.                                               |
| **Above basket**             | Slider before the line items.                                              |
| **Below basket**             | Slider directly after the items, before the subtotal.                      |
| **Bottom of the off-canvas** | Slider at the very bottom — below the buttons. Highly effective on mobile. |

### Show cross-selling slider in basket

Controls the slider on the dedicated basket page:

* **No**
* **Above basket**
* **Below basket**

### Show cross-selling slider in checkout

Controls the slider on the confirmation and checkout register page:

* **No**
* **Above checkout**
* **Below checkout**

## Recommended defaults

The following combination works well for most shops:

| Setting                          | Recommendation                            |
| -------------------------------- | ----------------------------------------- |
| Max. products in slider          | `8`–`10`                                  |
| Product sorting                  | Discount descending                       |
| Always show "Add to cart" button | On (unless you use many variant products) |
| Off-canvas                       | Bottom of the off-canvas                  |
| Basket                           | Below basket                              |
| Checkout                         | Above checkout                            |

That way customers see the slider at three key spots — without it interrupting the checkout.

## Different settings per sales channel

If you run multiple sales channels you can switch in the top selector and maintain different settings. For example: an eye-catching slider in B2C while only a subtle one below the basket in B2B.


---

# 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/configuration.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.