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

# Placements

Reference of all settings on the page "Placements & appearance" with default values and inheritance per sales channel.

On the page "Placements & appearance" you decide where recommendations appear in your shop without editing a Shopping Experience: in the offcanvas cart, on the cart page, in the customer account, on an intermediate page before checkout and together with the progress bar. For each placement you choose the recommendation template, and for the offcanvas and the cart page also the complete look of the cards. This page is a reference of all fields. How the placements behave in the storefront is described on the pages [Cart and offcanvas cart](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/cart-and-offcanvas-cart.md), [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), [Customer account](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/customer-account.md) and [Milestone recommendations](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/milestone-recommendations.md).

{% hint style="info" %}
The product page is not a placement on this page. Recommendations on product pages, category pages and landing pages are added as elements in your Shopping Experiences. See [Product page](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/product-page.md) and [Shopping Experience elements and card layouts](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/shopping-experience-elements.md).
{% endhint %}

## Opening the page

Open **Content → InsightSearch** and select **Delivery → Placements** in the sidebar. Below this item you find the sub items Offcanvas, Cart, Customer account, Checkout step and Milestones, which jump straight to the matching tab. In the plugin configuration, the placement cards also lead here with "Open settings".

At the top right you find "Support", "Cancel" (discards all unsaved changes) and "Save". If you switch tab or sales channel with unsaved changes, the page asks first ("Unsaved changes", button "Discard and continue").

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

## Sales channel and inheritance

At the very top, choose under "Sales channel" which channel you are editing.

| Selection                    | Effect                                                                                                                                  |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| empty ("All sales channels") | The values apply globally to all sales channels.                                                                                        |
| a specific channel           | Each field uses the global value as long as you do not set a value of its own in the channel. A channel value overrides the global one. |

Next to each field there is "Reset to default". Under "All sales channels" it resets the field to the plugin default, in a channel it returns the field to inheriting the global value.

"Reset design" resets all colours, fonts, spacing, buttons and visibility settings of a placement at once. Activation, template and position are kept. In a channel, the design values are removed and inherited from "All sales channels" again. The reset only takes effect with "Save".

{% hint style="info" %}
These are the same settings that used to be in the plugin configuration. Values from older versions are kept.
{% endhint %}

## Tabs and plans

| Tab              | Content                                                                | Plan                                               |
| ---------------- | ---------------------------------------------------------------------- | -------------------------------------------------- |
| Offcanvas        | Recommendations in the cart sidebar that opens after "Add to cart"     | from Starter                                       |
| Cart             | Recommendations on the cart page                                       | from Starter, layouts grid and list from Expert    |
| Customer account | Recommendations on the account overview for logged in customers        | from Expert                                        |
| Checkout step    | Intermediate page with a Shopping Experience between cart and checkout | all plans                                          |
| Milestones       | Products that close the gap to the next milestone of the progress bar  | from Starter, mode and price weighting from Expert |

If a placement is not included in your plan, its settings are locked and a notice with "Compare plans" appears. Included placements carry the badge "Included in the … plan".

The fields of each tab are arranged in groups: General, Layout, Colours, Typography, Spacing & shapes, Buttons, Visibility, Advanced.

## Tab "Offcanvas"

| Setting                   | Effect                                                                                                                                                                                                             | Default                  |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------ |
| "Enable"                  | Shows recommendations in the offcanvas cart.                                                                                                                                                                       | off                      |
| "Enable on mobile"        | Also shows the recommendations on mobile devices.                                                                                                                                                                  | on                       |
| "Mobile position"         | Where the recommendations sit on mobile devices: "Very top", "Before the first product", "After the last product", "Between voucher field and checkout button", "Between checkout and cart button", "Very bottom". | "After the last product" |
| "Recommendation template" | The template that supplies the products.                                                                                                                                                                           | empty                    |

All design fields are added (see below). The offcanvas design also applies to the cart page as long as "Like off-canvas" is selected there.

If you choose a template of the "cart continuation" type, a notice appears: in the cart this type often suggests products that are already in it. They are hidden, but usually only a few remain.

## Tab "Cart"

| Setting                          | Effect                                                                             | Default                      |
| -------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------- |
| "Enable"                         | Shows recommendations on the cart page.                                            | off                          |
| "Recommendation template"        | The template that supplies the products.                                           | empty                        |
| "Position"                       | "Below the cart (as before)" or "Above the products".                              | "Below the cart (as before)" |
| "Hide on mobile devices"         | Hides the recommendations below a width of 768 px. Nothing is loaded there either. | off                          |
| "Design"                         | "Like off-canvas" uses the offcanvas design, "Own design" shows all design fields. | "Like off-canvas"            |
| "Layout"                         | "Slider", "Grid" or "List". Grid and list from the Expert plan.                    | "Slider"                     |
| "Columns desktop (from 1200 px)" | Cards per row, 0 to 6.                                                             | 0 (automatic)                |
| "Columns tablet (768–1199 px)"   | Cards per row, 0 to 6.                                                             | 0 (automatic)                |
| "Cards on mobile (below 768 px)" | Cards per row, 0 to 6.                                                             | 0 (automatic)                |
| "Show arrows"                    | Slider layout only.                                                                | on                           |
| "Show dots"                      | Slider layout only.                                                                | on                           |
| "Auto-advance (seconds)"         | 0 to 30, slider layout only.                                                       | 0 (off)                      |

Heading and subheading are always set here, whichever design source is selected. With "Like off-canvas" you see the notice "The cart currently uses the offcanvas design." with the link "Edit design in the offcanvas tab".

## Design fields (offcanvas and cart)

These fields exist in the offcanvas tab and on the cart page with "Own design". Empty colour and size fields use the look of your theme; the grey placeholder shows the previous default value. Enter sizes as "Number and unit" or switch to "Enter custom value". Colours accept HEX, RGB or RGBA.

| Group            | Setting                                                                                                                                            | Default                            |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| General          | "Custom heading text" (empty = no heading), "Subheading"                                                                                           | empty                              |
| Colours          | "Heading color", "Card background", "Card border", "Image background", "Primary text color", "Secondary text color", "Price color"                 | empty (theme)                      |
| Typography       | "Heading font size", "Product name font size", "Price font size"                                                                                   | empty (theme)                      |
| Typography       | "Heading font weight", "Product name font weight", "Price font weight": "Inherit", "Normal (400)", "Medium (500)", "Semi-bold (600)", "Bold (700)" | "Inherit"                          |
| Typography       | "Heading alignment": Automatic, Left, Centred, Right                                                                                               | "Automatic (as before)"            |
| Typography       | "Lines for the product name": Automatic, 1, 2 or 3 lines, Unlimited                                                                                | "Automatic (2 lines)"              |
| Spacing & shapes | "Card border radius", "Image border radius", "Card padding", "Gap between cards"                                                                   | empty (theme)                      |
| Spacing & shapes | "Card shadow": Automatic, No shadow, Light, Strong                                                                                                 | "Automatic (as before)"            |
| Spacing & shapes | "Hover effect": None, Lift slightly, Highlight border                                                                                              | "None"                             |
| Layout           | "Image display": Automatic, Fit, Fill                                                                                                              | "Automatic (as before)"            |
| Buttons          | "Cart button color (theme)": Default, Primary, Secondary, Success, Danger, Dark, Light                                                             | Default (theme add-to-cart colour) |
| Buttons          | "Button background (custom override)", "Button text/icon color", "Button border radius"                                                            | empty                              |
| Buttons          | "Desktop cart button style": "Text button" or "Plus button"                                                                                        | "Plus button"                      |
| Buttons          | "Desktop details button style": "Text button" or "Icon button"                                                                                     | "Text button"                      |
| Buttons          | Details button: background, text/icon colour, border, each also for the hover state                                                                | empty                              |
| Visibility       | "Show product image", "Show brand", "Show badges", "Show price", "Show list price"                                                                 | all on                             |
| Advanced         | "Custom CSS class(es)", several separated by spaces                                                                                                | empty                              |

If live prices are switched on in the plugin configuration, "Show price" shows the price the customer actually pays in Shopware. See [Images, prices, fallbacks and visibility](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/images-prices-and-fallbacks.md).

### Live preview

In the offcanvas and cart tabs, a "Preview" on the right shows the cards with your settings. It uses real products of the selected template as well as colours and fonts from your theme. Changes your theme only makes in its own CSS cannot be shown.

* Under "Reference product" you choose the product for which the preview fetches recommendations. "Pick another" takes a different one.
* If the preview cannot show real products, sample cards appear together with the reason, for example "Sample cards: no template selected." or "Sample cards: this template is calculated from a customer's data."

## Tab "Customer account"

{% hint style="info" %}
Available from the Expert plan.
{% endhint %}

| Setting                                      | Effect                                                                       | Default  |
| -------------------------------------------- | ---------------------------------------------------------------------------- | -------- |
| "Enable recommendations in customer account" | Shows recommendations on the account overview, only for logged in customers. | off      |
| "Select recommendation template"             | The template that supplies the products, for example "Buy again".            | empty    |
| "Heading"                                    | Text above the recommendations. Empty = name of the template.                | empty    |
| "Subheading"                                 | Optional text below the heading.                                             | empty    |
| "Layout"                                     | "Slider", "Grid" or "List".                                                  | "Slider" |

Templates of the types "Similar products" and "Goes well with" need a source product, which does not exist in the customer account. The shop then shows personal recommendations automatically, without the Expert plan bestsellers. The page points this out when you select such a template. Details on the page [Customer account](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/customer-account.md).

## Tab "Checkout step"

| Setting                                     | Effect                                                                                                             | Default |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ------- |
| "Enable intermediate recommendation page"   | Adds a separate page between cart and checkout.                                                                    | off     |
| "Shopping experience for intermediate page" | The Shopping Experience shown on the intermediate page.                                                            | empty   |
| "Only with this rule"                       | A rule from the Shopware Rule Builder (**Settings → Rule Builder**). Empty = the intermediate page always appears. | empty   |

If the rule does not match, "Proceed to checkout" leads straight to the order overview. This also applies when someone opens the intermediate page directly. If the selected rule is deleted, the intermediate page no longer appears. A value in the sales channel overrides the global value. Walkthrough and examples: [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).

## Tab "Milestones"

This tab only works together with the "Progress bar" plugin. If it is not installed, not active, outdated or switched off, the tab shows a matching notice with a link to the Shopware Store. The colours of the progress bar are set in the "Progress bar" plugin, not here.

| Setting                                      | Effect                                                                                                                        | Default |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ------- |
| "Consider products up to the next milestone" | Switches milestone recommendations on.                                                                                        | off     |
| "Use in cart offcanvas"                      | Only works if recommendations are active in the offcanvas.                                                                    | on      |
| "Use on cart page"                           | Only works if recommendations are active on the cart page.                                                                    | on      |
| "Number of milestones"                       | For how many open milestones products are searched, 1 to 3.                                                                   | 1       |
| "Tolerance above the remaining amount (%)"   | How far the price may exceed the missing amount, 0 to 100. Example: 20 € are missing, with 30 % products from 20 to 26 € fit. | 30      |
| "Positions at the front"                     | How many front positions matching products get, 1 to 6.                                                                       | 3       |
| "Mode" (from Expert)                         | "Weight (similar products stay, matching price moves up)" or "Matching products only".                                        | Weight  |
| "Price weighting (%)" (from Expert)          | How much the matching price counts compared with similarity, 0 to 100.                                                        | 50      |

Without the Expert plan, "Mode" and "Price weighting (%)" are hidden. Milestone recommendations count towards your monthly request quota. See [Milestone recommendations](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/milestone-recommendations.md).

## Permissions

Only users who may manage plugins in Shopware can edit this page. Everyone else sees: "You are not allowed to change these settings."

## When changes take effect

Changes apply after "Save". If your shop uses a page cache, you may need to clear it before customers see the change. See [When do changes take effect?](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/when-changes-take-effect.md)

## Read more

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

{% 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/zpckY2pGVQ6w0tzYP3Yo" %}
[Customer account](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/customer-account.md)
{% endcontent-ref %}

{% content-ref url="/pages/v0RzTVJFjsXNoeFkgj6R" %}
[Product page](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/product-page.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/placements.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.
