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

# Templates

What templates are in Cross Selling Pro, where they take effect and how to manage the template list.

Templates are the central building blocks of Cross Selling Pro. In a template you define once which products are recommended, how they are selected and sorted, and how many appear. You then pick that template wherever recommendations should show up. When you change the template, every place that uses it changes too.

A template on its own shows nothing in the shop. It only becomes visible once you embed it in a Shopping Experience or at a placement (for example in the cart).

## Two kinds of templates

| Kind                        | Purpose                                                                                                                     | Plan                                                           |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| **Recommendation template** | Controls one recommendation block: recommendation type, where the products come from, filters, weighting, count and button. | from plan Basic (some types and features only in higher plans) |
| **Bundle/set template**     | Groups several products that shoppers select next to a main product and add to the cart together.                           | from plan Expert                                               |

This page and the following sub-pages cover recommendation templates. Bundle/set templates have their own page.

## Where recommendation templates take effect

One recommendation template can be in use in several places at once:

| Place                                                                        | How to embed the template                                                                                              | Plan                               |
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| Shopping Experiences (product page, home page, category pages, custom pages) | Add a block from the “AI CrossSelling” category and choose the template in the element field “Recommendation template” | type and layout determine the plan |
| Off-canvas cart                                                              | Placements, sub-item “Offcanvas”, field “Recommendation template”                                                      | from plan Starter                  |
| Cart page                                                                    | Placements, sub-item “Cart”, field “Recommendation template”                                                           | from plan Starter                  |
| Customer account                                                             | Placements, sub-item “Customer account”, field “Select recommendation template”                                        | from plan Expert                   |
| As a fallback in another template                                            | In the other template under “5. Display”, set “Fallback type” to “Other template”                                      | same as the template itself        |
| To fill up a bundle/set template                                             | In the bundle/set template, card “Recommendations”                                                                     | from plan Expert                   |

The checkout interstitial page shows a Shopping Experience. Which templates run there is decided by the elements in that Shopping Experience.

{% hint style="info" %}
It also works the other way round: a bundle/set template can be the source of a recommendation template. The recommendation block then shows the products of that bundle/set template.
{% endhint %}

## The template list

In the Shopware Administration open **Content → InsightSearch** and then, in the sidebar, **Delivery → Recommendation templates**.

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-3f40d0ec976a908ffee5a160ad6e9d8552c31c61%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-vorlagen-liste.png?alt=media" alt="List of recommendation templates with name and type"><figcaption></figcaption></figure>

The list shows for each template:

| Column       | Content                                                           |
| ------------ | ----------------------------------------------------------------- |
| “Name”       | The internal name. A click opens the template.                    |
| “Type”       | The recommendation type in plain text, for example “Bestsellers”. |
| “Updated at” | When the template was last saved.                                 |

The menu at the end of each row offers “Edit” and “Delete”. To create a new template, use “Create template” at the top right.

If there is no template yet, you see “No templates yet”. The overview of the plugin dashboard then also offers the setup wizard.

{% hint style="danger" %}
**Deleting happens without a confirmation prompt.** A click on “Delete” removes the template immediately. Shopping Experiences and placements that use it stop showing recommendations. Check where the template is embedded before you delete it.
{% endhint %}

## Structure of a recommendation template

The template form is split into cards from top to bottom. The numbered sections follow the order in which InsightSearch calculates: first where the products come from, then the filters, then the order, and finally the display.

| Card           | What you set there                                                              | Details                                                                                                                                                                             |
| -------------- | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| “Quick start”  | A “Preset” sets proven starting values for one use case.                        | [Creating recommendation templates](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/recommendation-templates.md) |
| “General”      | Name, recommendation type, internal description                                 | [Creating recommendation templates](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/recommendation-templates.md) |
| “1. Source”    | Where the products come from, fixed products, reference product in the cart     | [Creating recommendation templates](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/recommendation-templates.md) |
| “2. Filters”   | Which products qualify at all, rule builder                                     | [Filters and rule builder](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/filters-and-rule-builder.md)          |
| “3. Weighting” | The order in which the remaining products appear                                | [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)   |
| “4. Boosters”  | Extra points for the same brand or category (expert mode only)                  | [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)   |
| “5. Display”   | Count, button action, fallback when there are too few results                   | [Creating recommendation templates](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/recommendation-templates.md) |
| “Preview”      | Test the result of the template before it goes live (only after the first save) | [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)                    |

### Simple or detailed: the expert mode

At the top right of a template page you find the switch “Show expert mode”. Without it you see only the most important fields. With it you also see the rule builder, the fine-tuning of the weighting, the section “4. Boosters” and further switches and number fields.

The expert mode does not change the template, it only shows more fields. It is not saved and is off again the next time you open the template. Values you set in expert mode stay saved and keep working when the switch is off.

## Three ways to your first template

1. **Setup wizard:** In the plugin dashboard at the top right, “Setup wizard”. It creates several templates with simplified settings in one go and can assign templates to the cart.
2. **Preset:** Create a new template and pick a “Preset” in the “Quick start” card, for example “Accessories (product page)” or “Bestsellers”. Every value can be changed afterwards.
3. **By hand:** Create a new template and fill in the sections yourself. A new template starts with the type “Similar products (alternatives)”, “Limit” 6 and the button action “Add to cart”.

## One template, many places

Because one template can be attached to many places, a clear approach pays off:

* **Meaningful names:** The name is only visible in the Administration. Name the place and purpose, for example “PDP accessories” or “Cart add-ons”.
* **Use the description:** In the “Description” field note where the template is embedded. This helps before deleting it or making larger changes.
* **One template per purpose:** If you want to try something in one place, create a copy with a new name instead of changing a template that runs in many places.
* **Plan a fallback:** Types that need order or visitor data deliver little in new shops at first. Under “5. Display”, set a fallback template, for example one with the type “Bestsellers”.

## When does a change take effect?

Saved changes to a template apply from the next recommendation the shop requests. Cached Shopping Experience pages that use the template are discarded automatically when you save, so you do not need to clear the cache for this.

Changes to product data (price, stock, category) only take effect once InsightSearch has read in the product data again.

## Read more

{% 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 %}

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

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


---

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