> 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/how-to-guides.md).

# How-to guides

Nine step-by-step guides for typical tasks with Cross Selling Pro, from accessories on the product page to promotions and seasonal items.

Here you find typical everyday shop tasks as short step-by-step guides. Each guide states the goal, the steps in the admin and the required plan. The linked topic pages describe the settings in detail.

{% hint style="info" %}
All paths start in the Shopware admin under **Content → InsightSearch**. The plugin dashboard has a sidebar on the left with the groups "Overview", "Delivery", "Products & data" and "System".
{% endhint %}

## 1. Show accessories on the product page

**Goal:** Matching add-ons appear below every product.

1. In the sidebar, open **Delivery → Recommendation templates** and click "Create template".
2. In the card "Quick start", choose "Accessories (product page)" in the field "Preset". The admin description reads: "Frequently bought together products of matching product types; without purchase data, similar matching products. Available products first."
3. Enter a name, for example "Accessories product page", and save.
4. Optional: switch on "Show expert mode" at the top and enable "Exclude cart products" in the filters section. With the rule builder (from the Expert plan), you can for example add the building block "Only in stock".
5. Go to **Content → Shopping Experiences** and open the layout of your product page.
6. Add a block from the category "AI CrossSelling", for example "AI CrossSelling: Standard-Karten". The block names are in German, also in the English admin.
7. In the element, choose your new template under "Recommendation template" and enter a title.
8. Save the layout and assign it to the product or as the default layout for product pages. The product source "Automatic (PDP)" is preset and uses the current product.
9. Check the result in the template preview and in the shop.

**Alternatives:** "Automatic (recommended)" tends to show alternatives rather than accessories. "Frequently bought together (purchase data only)" uses order data only and needs at least two joint purchases (from the Expert plan).

{% hint style="info" %}
"Matching types" in the field "Product type" only works if product type detection (beta) has been enabled for your shop by InsightSearch. Otherwise it behaves like "Off".
{% endhint %}

**Plan:** The type "Similar products (alternatives)" is included from Basic. The layouts "Standard-Karten" and "Minimal" are available in every plan, "Kompakt" and "Große Kacheln" from Starter, "Detailkarten", "Raster", "Liste", "Mosaik" and "Spotlight" from Expert. A layout not included in your plan shows nothing in the shop.

More: [Product page](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/product-page.md), [Recommendation templates](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/recommendation-templates.md).

## 2. Recommendations in the cart (offcanvas and cart page)

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

**Goal:** The slide-in cart and the cart page show add-ons for the products in the cart.

1. Create a template with the preset "Cart: matching accessories". It mixes recommendations for all line items and excludes cart products.
2. In the template's source section, choose under "Cart: reference product" which line item recommendations are based on:

   * "Highest line value (price × quantity)" (default)
   * "Highest unit price"
   * "Most recently added"
   * "Mix of several lines" (up to five line items)

   Free line items never count.
3. Open **Delivery → Placements → Offcanvas**. Choose a sales channel at the top or keep all sales channels. Values of a channel override the general ones, the chain icon restores inheritance.
4. Switch on "Enable", choose the "Recommendation template" and decide whether recommendations also appear on mobile ("Enable on mobile", "Mobile position", default "After the last product"). Colours, font and cards are set in the same area, with a preview on the right.
5. Open the sub-item **Cart**: "Enable", "Recommendation template", "Position" ("Below the cart (as before)" or "Above the products"), "Hide on mobile devices" and the design ("Like off-canvas" or "Own design"). The layouts "Grid" and "List" are available from the Expert plan.
6. Save. Offcanvas and cart page are not cached and show the change immediately.

{% hint style="warning" %}
Do not choose a template of the type "Continue where you left off" here. Its products are usually already in the cart and are excluded there. The admin warns you in this case.
{% endhint %}

Products in the cart and their variants are always excluded in the offcanvas, on the cart page and on the checkout interstitial page. [Milestone recommendations](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/milestone-recommendations.md) are a useful addition.

More: [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), [Placements](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/placements.md).

## 3. Show the checkout interstitial page only from a rule

**Goal:** A separate page with recommendations appears between cart and checkout, but only if the cart meets a condition, such as "at least 3 products".

The interstitial page shows a shopping experience, for example with recommendation sliders. The checkout step itself has no plan restriction. The sliders on the page, however, are subject to the limits of their type and layout.

1. **Create a shopping experience:** Under **Content → Shopping Experiences**, create a layout with one or more "AI CrossSelling" blocks. There is no current product on this page. Therefore choose templates without product reference, for example "Bestsellers" or "Trends".
2. **Create a rule:** Under **Settings → Rule Builder**, create a rule, for example for the number of products in the cart or the cart value.
3. Open **Delivery → Placements → Checkout step**:
   * switch on "Enable intermediate recommendation page"
   * choose the "Shopping experience for intermediate page"
   * set "Only with this rule" to your rule
4. Save and test in the shop once with and once without the rule being met.

This is how the field "Only with this rule" behaves:

| Case                | Result                                                                                                                        |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Field empty         | The interstitial page always appears                                                                                          |
| Rule applies        | The interstitial page appears                                                                                                 |
| Rule does not apply | "Proceed to checkout" leads straight to the order overview. This also applies if someone opens the interstitial page directly |
| Rule was deleted    | The interstitial page never appears                                                                                           |

The setting applies per sales channel. The value of a channel overrides the general one.

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-b20853c67d276bd643a7ef779251f429abb5c57f%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-ausspielorte-checkout.png?alt=media" alt="Checkout step section with switch, layout and rule field"><figcaption></figcaption></figure>

More: [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).

## 4. Create a bundle or set

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

**Goal:** On the product page, the customer puts together a set of main product and add-ons and adds everything to the cart with one click.

1. Open **Delivery → Bundle/set templates** and click "Create template".
2. Choose the **source**: "Fixed products", "Dynamic product stream" or "Cross-selling (from reference product)".
3. Set the other fields: "Limit", "Enable selection (checkboxes)", "Include main product in total & cart", "Show only available products", "Product view" and, if needed, "Enable fixed product count" with "Product count". With "Recommendation template", the set can be filled up from a recommendation template.
4. Save.
5. Under **Content → Shopping Experiences**, open the layout of your product page and add the element "Cogi Bundle/Set Configurator". It is only available in layouts of the type product page.
6. Choose your template in the field "Set template", save and check the result in the shop.

{% hint style="warning" %}
There is **no set discount**. The set price is the sum of the individual prices. The set only shows savings through list prices of the products.
{% endhint %}

* Products that have to be designed before purchase (Printess, Custom Products) cannot be selected in the set.
* The main product of a set does not count as revenue from recommendations.
* To create many cross-sellings at once, use **Catalogues → Quick Cross-Selling** and then the source "Cross-selling (from reference product)".

More: [Bundle and set templates](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/bundle-and-set-templates.md), [Quick cross-selling assignment](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/quick-cross-selling-assignment.md).

## 5. Prefer products in stock

**Goal:** Products in stock move up in the recommendations.

1. Open your recommendation template.
2. In the filters section, switch on "Prefer products in stock". The help text reads: "Products in stock move up (booster). Out-of-stock products remain possible. To hide them completely: building block “Only in stock” in the rules."
3. Save.

The presets for accessories and cart already switch this booster on. Availability comes from Shopware and takes effect from the next transfer of product data.

With "Show expert mode", the boosters section appears as well. It contains "Brand boost", "Category boost" and "Path boost". A value of 1 means no effect.

{% hint style="info" %}
There is no booster for margin, purchase price or newness. Custom booster rules cannot be created in the admin. From the Expert plan, you can transfer your own field from the shop (for example a custom field "margin class" under **Products & data → Data fields** with "Edit data fields") and filter by it in the rule builder. That is a hard filter, not a preference. For targeted placement, use "Fixed products" (guide 6).
{% endhint %}

Do not confuse: the [Conversion Booster](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/conversion-booster.md) is a separate element for landing pages from Google Shopping (from the Advanced plan).

More: [Weighting, diversity and boosters](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/weighting-and-boosters.md).

## 6. Fixed products for a promotion

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

**Goal:** Certain products always appear at the very front of a recommendation, for example for a promotion.

1. Open the template.
2. In the source section, choose the products under "Fixed products". According to the help text, they "are shown first and count towards the limit".
3. Save. The change takes effect immediately, cached pages with this template are discarded on saving.

* The number of calculated recommendations drops by the number of fixed products. With a limit of 6 and 2 fixed products, 4 calculated ones are added.
* If a fixed product is the product currently shown or is in the cart, it is left out. The visibility check also applies to fixed products.
* Fixed products apply on **all** pages where the template runs. For a promotion on only some products, create a separate template and a separate layout.
* Remove the fixed products again after the promotion.

## 7. Test a template before going live

**Goal:** You see in advance which products a template delivers, without customers noticing.

### Preview in the template

1. Open the template. It contains the card "Preview" with the note "Calculates 1:1 with this template's settings."
2. Choose the "Index" and, depending on the type, a "Reference product" or a "Customer".
3. Click "Refresh preview" or switch on "Auto refresh".
4. Read the counts, for example "198 products in the index · 194 match the rules · 6 shown". Below, you see which filters applied and which were dropped.

The preview does not count towards your request quota.

### Recommendation sandbox

You find the sandbox under **Products & data → Products**. It saves nothing and has no effect on the shop.

1. Choose the starting product by number or title, for variants from the list.
2. Choose one of your templates or a type without template.
3. Override individual values if needed. Empty fields take over the template.
4. View a single result or compare two settings in an A/B comparison. The comparison shows identical products, identical positions and differing settings.
5. Check why a product was recommended, and look at applied and dropped filters in the diagnosis.

### Going live with low risk

* First add a new template to a shopping experience that is not assigned, or to a test sales channel. Placements can be set per sales channel.
* In the element, set a fallback threshold and as "Fallback type", for example, "Other template" with bestsellers. Then the block never stays empty.
* After going live, watch the statistics (from the Expert plan) or the tile in the cogi Commander.

More: [Preview and sandbox](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/preview-and-sandbox.md).

## 8. Add recommendations to a shopping experience

**Goal:** A recommendation slider on the home page, a category or a landing page.

1. Create a template that fits the page:
   * Home page or category: "Bestsellers" (from Starter) or "Trends" (from Expert)
   * Product page: "Automatic (recommended)" or "Accessories (product page)"
   * Personalised types only if tracking data is available (from Expert)
2. Under **Content → Shopping Experiences**, open the layout and add a block from "AI CrossSelling".
3. Configure the element: "Title", "Subtitle", "Show Brand", "Show Description", "Show Badges", "Show Price" and above all the "Recommendation template". In the design tab, you set font size, font weight and a custom CSS class.
4. Save and assign the layout, for example in the category on the layout tab.
5. Several blocks with different templates on one page are possible.

{% hint style="warning" %}
On pages without a current product (home page, category, landing page), the product source "Automatic (PDP)" finds nothing. Use a type without product reference there, such as "Bestsellers" or "Trends".
{% endhint %}

* A template only appears in the shop once it is used in a block or at a placement.
* When you save the template, affected pages are discarded from the cache immediately. Changed block settings in the shopping experience follow the normal Shopware cache.

More: [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).

## 9. Campaigns and seasons

**Goal:** Adjust recommendations for a promotion or season.

There is no time control for templates. With the existing features you can still get far:

1. **Fixed products** for the duration of the promotion, removed afterwards (guide 6).
2. **Dynamic product stream** as source or fallback of a template, with the stream controlled in Shopware, for example via tags, a "promotion" category or properties. If you only change the product stream, the recommendations change without touching the template. With shop sources, filters, weighting and boosters are locked.
3. **Checkout interstitial page** linked to a rule with a date condition. It then only appears during the promotion (guide 3).
4. **Separate shopping experience** for the promotion, for example a landing page with a bestseller or trend slider.
5. **Swap the template** in the block or at the placement. Offcanvas and cart show this immediately, shopping experiences after clearing the cache.
6. **Milestone:** The threshold, for example for free shipping, comes from the progress bar. Change it there and the recommendations follow.
7. **Sell off seasonal items:** in the rule builder (from Expert), filter on a shop field such as "season" and exclude products not in stock with "Only in stock".

## Read more

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

{% content-ref url="/pages/e00VEeT8TubzE8TB5J6M" %}
[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)
{% endcontent-ref %}

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

{% content-ref url="/pages/H7hG7KNHBotOdMhNijf5" %}
[Requirements and plans](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/requirements-and-plans.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/how-to-guides.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.
