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

# Getting started

A few steps from a finished setup to your first recommendations on the product page and in the cart.

This guide takes you quickly from a finished setup to visible recommendations in the shop. You create a template, add it to the product page and, if you like, switch on recommendations in the side cart. The time estimate applies once your products have been read in.

## Requirements

* The plugin is installed and activated. See [Installation](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/installation.md).
* The setup wizard is finished and your products are indexed. See [Setup wizard: product feed](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/setup-wizard-product-feed.md).

{% hint style="info" %}
Prefer a guided path? The [setup assistant](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/configuration-assistant.md) creates several templates at once. This page shows the manual way so you get to know the most important places.
{% endhint %}

## Step 1: Check the status

Open **Content → InsightSearch**. The overview shows the card "System status".

* "Connection" should show "Connected".
* "Data sources" should count at least one data source.
* If the notice "Data sources exist, but none are assigned to a language/sales channel yet." appears, click **"Assign languages"**. Assign your sales channels and languages to the data source there and save. Without this assignment, the shop does not deliver any recommendations.

## Step 2: Create a template

A template defines which products are recommended. For the product page, similar or matching products work well.

1. In the sidebar, open **Delivery → Recommendation templates** and click **"Create template"**.
2. In the **"Quick start"** card, choose **"Automatic (recommended)"** in the "Preset" field. It sets proven starting values for similar products and prefers products in stock.
3. Under "General", enter a "Name", for example "Product page similar". The name is only visible in the Administration.
4. Click **"Save"**.

<details>

<summary>Which preset suits the product page?</summary>

| Preset                                            | Purpose                                                                                                     | From plan |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | --------- |
| "Automatic (recommended)"                         | Similar products as alternatives. Works from day one, even without orders.                                  | Basic     |
| "Accessories (product page)"                      | Products often bought together of matching product types; without purchase data, similar matching products. | Basic     |
| "Frequently bought together (purchase data only)" | Only real joint purchases. Needs order history.                                                             | Expert    |

The "matching types" setting in the preset "Accessories (product page)" only works with product type detection. This is a beta feature that InsightSearch unlocks for you. Without it, the preset behaves as if no product type were set.

</details>

## Step 3: Add it to the product page

Templates only appear in the shop once they are embedded. On the product page this is done through a Shopping Experience.

1. Open **Content → Shopping Experiences** and the layout of your product page (type product page).
2. Add a block from the category **"AI CrossSelling"**, for example **"AI CrossSelling: Standard-Karten"**. The block names are in German, also in the English Administration.
3. In the element, select your new template under **"Recommendation template"**. Enter a title, for example "Goes well with".
4. Save the layout and assign it to the products (standard Shopware, for example as the default layout for product pages).

The product source is set to "Automatic (PDP)": the recommendations then always refer to the product the customer is currently viewing.

{% hint style="warning" %}
The blocks "Standard-Karten" and "Minimal" are included from Basic, "Kompakt" and "Große Kacheln" from Starter, all other layouts from Expert. A block with a layout that is not in your plan shows nothing in the shop.
{% endhint %}

## Step 4: Recommendations in the side cart

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

The side cart (offcanvas) opens as soon as a customer adds something to the cart. You do not need a Shopping Experience for this.

1. Create another template as in step 2, this time with the preset **"Cart: matching accessories"**. It mixes recommendations for all cart items and excludes products already in the cart.
2. Open **Delivery → Placements** and the section **"Offcanvas"**.
3. Leave "All sales channels" at the top or choose a sales channel.
4. Switch on **"Enable"** and select the new template under **"Recommendation template"**.
5. Click **"Save"**.

For the cart page, do the same in the section **"Cart"**. Changes to offcanvas and cart take effect immediately.

## Step 5: Test

* **Preview in the template:** open the saved template again. The "Preview" card calculates exactly with the template's settings. Choose a "Reference product" and click "Refresh preview". The preview only appears after the first save.
* **Recommendation sandbox:** under **Products & data → Products** you can try templates on any product and compare two settings. The sandbox saves nothing and does not affect the shop.
* **In the shop:** open a product page and add a product to the cart.

See [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) for more.

## Tip: avoid empty blocks

If a template finds no products, the block disappears from the page. To make sure something always appears, set a fallback in the template in section **"5. Display"**:

| Setting                  | Recommendation                                                                         |
| ------------------------ | -------------------------------------------------------------------------------------- |
| "Fallback threshold (≤)" | For example 2. The fallback applies as soon as at most this many products were loaded. |
| "Fallback type"          | "Other template", "Fixed products" or "Dynamic product stream".                        |
| "Fallback template"      | For example a bestseller template (bestsellers from plan Starter).                     |

## 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/NpS6UuPrr6DqxFgdMPmA" %}
[Shopping experience elements](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/shopping-experience-elements.md)
{% endcontent-ref %}

{% 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/4D3JvLVV6WwwtMOw6rFl" %}
[How-to guides](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/how-to-guides.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/getting-started.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.
