> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/cart-and-offcanvas-cart.md).

# Cart and offcanvas cart

How to show recommendations in the offcanvas cart and on the cart page with Cross Selling Pro.

In the cart, the customer has already made a decision. That is exactly the right moment for additions such as accessories, consumables or a small extra. Cross Selling Pro shows such recommendations in two places: in the offcanvas cart (the sidebar that opens after "Add to cart") and on the cart page. Unlike on the product page, you do not need a shopping experience for this. You turn on both areas in the plugin dashboard and select a template.

{% hint style="info" %}
Available from plan Starter. The layouts "Grid" and "List" on the cart page are available from plan Expert.
{% endhint %}

## Where to find the settings

In the Administration, open "Content → InsightSearch" and, in the sidebar, "Delivery → Placements". There you find the sub-items "Offcanvas" and "Cart". The page is called "Placements & appearance".

At the very top, choose the "Sales channel". With "All sales channels", your values apply to every channel. Values you set for a single channel override the general values. This way you can, for example, use a different template in your B2B shop than in your consumer shop.

In the plugin configuration, offcanvas and cart only have a card with the button "Open settings". It leads to the same page.

## Step by step

1. Create a template under "Delivery → Recommendation templates". The quick start with the preset "Cart: matching accessories" is made for this. It "mixes recommendations for all line items, cart products excluded". Save the template.
2. Open "Delivery → Placements → Offcanvas".
3. Turn on "Enable" and select your template under "Recommendation template".
4. If needed, adjust "Mobile position" and the design. The preview on the right shows real products from your template.
5. Switch to "Cart", turn on "Enable" and select a template. If you leave the field empty, the cart page uses the offcanvas template.
6. Click "Save".
7. Add a product to the cart in your shop and check both areas, on desktop and on a phone.

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-180d4f6207950adc7b6e6afd3c0a68ca561446fd%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-ausspielorte-offcanvas.png?alt=media" alt="Placements page, Offcanvas section with preview"><figcaption></figcaption></figure>

## Which product in the cart counts?

Many recommendation types work with a source product (reference product). The cart often contains several products. You define which one counts in the template, field "Cart: reference product". It only applies to the offcanvas cart and the cart page.

| Option                                  | Effect                                                                   |
| --------------------------------------- | ------------------------------------------------------------------------ |
| "Highest line value (price × quantity)" | The line with the highest total value counts. Default.                   |
| "Highest unit price"                    | The most expensive single product counts.                                |
| "Most recently added"                   | The product added last counts.                                           |
| "Mix of several lines"                  | Up to 5 lines, the most expensive first. The results are mixed in turns. |

Free lines (for example free gifts) never count. If there is a tie, the first line wins.

Products that are already in the cart are always excluded in the offcanvas cart and on the cart page, including their variants.

{% hint style="warning" %}
If you select a template of the type "Continue where you left off", the Administration shows a notice. This type often suggests products that are already in the cart. They are hidden, but usually only a few remain. Complementary templates or bestsellers work better here.
{% endhint %}

## Offcanvas cart

### Settings

| Setting                   | Effect                                                                                                                                                                                                          | Default                  |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| "Enable"                  | Shows recommendations in the offcanvas cart.                                                                                                                                                                    | off                      |
| "Enable on mobile"        | Also shows the recommendations on screens below 768 px.                                                                                                                                                         | on                       |
| "Mobile position"         | Where the recommendations appear on phones: "Very top", "Before the first product", "After the last product", "Between voucher field and checkout button", "Between checkout and cart button" or "Very bottom". | "After the last product" |
| "Recommendation template" | The template that supplies the products. Without a template nothing appears.                                                                                                                                    | none                     |

### What your customers see

**On desktop**, the offcanvas becomes wider. A separate column with recommendations appears to the left of the cart.

**On phones** (below 768 px), the recommendations appear at the chosen position in the cart as a horizontal list to swipe through. If the chosen position is missing, for example because a button is not shown, they appear after the last product.

A heading only appears if you enter a "Custom heading text" in the design. Without it, the column has no heading.

The recommendations are reloaded every time the cart opens and every time the cart changes. They adapt when the customer adds more products.

## Cart page

### Settings

| Setting                          | Effect                                                                                                      | Default                      |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------- | ---------------------------- |
| "Enable"                         | Shows recommendations on the cart page.                                                                     | off                          |
| "Recommendation template"        | The template for the cart page. Empty = the offcanvas template.                                             | none                         |
| "Position"                       | "Below the cart (as before)" or "Above the products".                                                       | "Below the cart (as before)" |
| "Hide on mobile devices"         | Hides the recommendations below 768 px. No recommendations are loaded and no impressions are counted there. | off                          |
| "Design"                         | "Like off-canvas" uses colours, fonts and shapes from the offcanvas. "Own design" shows separate fields.    | "Like off-canvas"            |
| "Layout"                         | "Slider", "Grid" or "List". Grid and list from plan Expert, otherwise the slider is shown.                  | "Slider"                     |
| "Columns desktop (from 1200 px)" | How many products are shown side by side, 0 to 6. 0 = automatic by width.                                   | 0                            |
| "Columns tablet (768–1199 px)"   | As above, for tablets.                                                                                      | 0                            |
| "Cards on mobile (below 768 px)" | How many cards of the swipe list are visible at once. 0 = automatic.                                        | 0                            |
| "Show arrows"                    | Arrows to scroll, slider only.                                                                              | on                           |
| "Show dots"                      | Dots below the slider, slider only.                                                                         | on                           |
| "Auto-advance (seconds)"         | Advances every X seconds (0 to 30) and pauses while the mouse is over it. 0 = off.                          | 0                            |

### What your customers see

"Below the cart" means: after the area where customers add a product by number and see the shipping information. "Above the products" places the recommendations before the list of cart lines.

On phones the compact swipe list always stays, even if you selected "Grid" or "List".

If a customer adds a recommended product to the cart on the cart page, the cart page reloads. The offcanvas cart does not open.

On the cart page, the cards show the price your shop sent to InsightSearch. The setting "Show live prices from Shopware" has no effect there.

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-c6636668fd55a9434d331ee7a1543f5ce5f58f66%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-shop-offcanvas-warenkorb.png?alt=media" alt="Offcanvas cart in the shop with recommendations on the left"><figcaption></figcaption></figure>

## Design

You set the look of the cards in the "Offcanvas" area. The cart page uses it as long as "Like off-canvas" is selected there. With "Own design", the cart page gets the same fields again for itself. Empty fields and "Automatic" mean the previous look stays.

| Group            | Example settings                                                                                                                                                        |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| General          | "Custom heading text", "Subheading"                                                                                                                                     |
| Colours          | "Heading color", "Card background", "Card border", "Image background", "Price color"                                                                                    |
| Typography       | Font size and font weight for heading, product name and price, "Heading alignment", "Lines for the product name"                                                        |
| Spacing & shapes | "Card border radius", "Image border radius", "Card padding", "Gap between cards", "Card shadow", "Hover effect"                                                         |
| Layout           | "Image display" ("Fit" or "Fill")                                                                                                                                       |
| Buttons          | "Cart button color (theme)", "Desktop cart button style" (default "Plus button"), "Desktop details button style" (default "Text button"), colours of the details button |
| Visibility       | "Show product image", "Show brand", "Show badges", "Show price", "Show list price" (all on by default)                                                                  |
| Advanced         | "Custom CSS class(es)"                                                                                                                                                  |

With "Reset design" you reset all design values of a placement to their defaults at once. Activation, template and position are kept. The change takes effect only after "Save".

The preview on the right shows real products from the selected template with colours and fonts from your theme. With "Pick another" you choose a different reference product.

## Buttons on the cards

The template defines which buttons appear (field "Button action"). In the offcanvas cart and on the cart page, all three options work: "Show details", "Add to cart" and "Details + cart". With the combination, the card gets both buttons. Products with variants show "Choose variant" instead of adding any variant.

## Milestone recommendations

If you also use the progress bar plugin ("Fortschrittsbalken"), products whose price closes the gap to the next milestone, for example free shipping, can move to the front in the offcanvas cart and on the cart page. You set this up in the "Milestones" area. It only works if a template is active for the respective area. More on the page about milestone recommendations.

## Frequently asked questions

<details>

<summary>No recommendations appear in the offcanvas cart.</summary>

Check: Is "Enable" on for this sales channel (or inherited from "All sales channels")? Is a template selected? Does your plan include the offcanvas cart (from Starter)? On phones: Is "Enable on mobile" on? If the cart only contains free lines, there is no reference product, and product-based templates find nothing.

</details>

<details>

<summary>Only very few products appear.</summary>

Cart products and their variants are always excluded. With small product ranges or templates of the type "Continue where you left off", little remains. A fallback with "Fixed products" or "Dynamic product stream" in the template fills up the list. The fallback "Other template" does not work in the offcanvas cart and on the cart page.

</details>

<details>

<summary>Grid or list is not shown.</summary>

These layouts are available from plan Expert. In smaller plans the slider appears instead. On phones the swipe list always stays.

</details>

## Read more

{% content-ref url="/pages/ZqlaxM46y9FRY9f2c9u3" %}
[Checkout interstitial page](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/checkout-interstitial-page.md)
{% endcontent-ref %}

{% content-ref url="/pages/aWOVJOLpaxjqIBUOS3rz" %}
[Milestone recommendations](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/milestone-recommendations.md)
{% endcontent-ref %}

{% content-ref url="/pages/T18Rtfo4NyPNuI34n60w" %}
[Placements](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/placements.md)
{% endcontent-ref %}

{% content-ref url="/pages/hSRY2MxmbdY5dCCa9KY4" %}
[Creating recommendation templates](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/recommendation-templates.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/cart-and-offcanvas-cart.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
