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

# Product page

How to show matching recommendations on your product pages with Cross Selling Pro.

The product page is the most common place for recommendations: accessories, alternatives or products that are often bought together. Cross Selling Pro does not insert anything there automatically. You decide where and how recommendations appear by placing an element in your product page layout. This page explains how to do that and what your customers see afterwards.

## How recommendations get onto the product page

Recommendations on the product page always consist of two parts:

* a **recommendation template**: it defines which products are recommended (type, filters, weighting, number).
* an **element in the product page layout**: it defines where the recommendations appear and what the cards look like.

The element automatically uses the product of the current page as the source product (reference product). You do not need a separate setting for each product. One layout is enough for all products it is assigned to.

### Step by step

1. In the Administration, open "Content → InsightSearch" and, in the sidebar, "Delivery → Recommendation templates".
2. Click "Create template". For accessories, use the quick start with the preset "Accessories (product page)". Enter a name, for example "Accessories product page", and save.
3. Open "Content → Shopping Experiences" and the layout of your product page (layout type product page).
4. Insert a block from the category "AI CrossSelling" where you want it, for example "AI CrossSelling: Standard-Karten".
5. In the element, select your new template under "Recommendation template". Optionally enter a "Title", such as "Goes well with".
6. Save the layout and assign it to your products as usual in Shopware.
7. Check the result first in the template preview and then on a real product page in your shop.

{% hint style="info" %}
You set the number of products shown in the template (field "Limit"), not in the element. In the element you only choose the template, title, subtitle and whether brand, description, badges and price are shown.
{% endhint %}

## Which recommendation types suit the product page?

The product page has a source product. That is why the types that work with a product fit best here:

| Type in the Administration                    | What customers see                                                                                              | Plan        |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------- |
| "Similar products (alternatives)"             | Products with similar properties such as category, brand, attributes and price range. Works without any orders. | from Basic  |
| "Goes well with (frequently bought together)" | Products that are frequently bought together with the product. Needs real order data.                           | from Expert |

Types without a source product also work on the product page, for example "Recently viewed" (from Basic), "Bestsellers" (from Starter) or "You may also like" (from Expert). They then show the same products or customer-based products, regardless of the product being viewed.

{% hint style="info" %}
On pages without a product (home page, category pages), product-based types usually find nothing, and the block is not shown. Bestsellers, trends, personal recommendations or recently viewed products are the better choice there.
{% endhint %}

## Layouts for the product page

You choose the card design through the element itself. There are nine recommendation elements in the category "AI CrossSelling":

| Element                            | Kind                       | Plan         |
| ---------------------------------- | -------------------------- | ------------ |
| "AI CrossSelling: Standard-Karten" | slider                     | from Basic   |
| "AI CrossSelling: Minimal"         | slider                     | from Basic   |
| "AI CrossSelling: Kompakt"         | slider                     | from Starter |
| "AI CrossSelling: Große Kacheln"   | slider                     | from Starter |
| "AI CrossSelling: Detailkarten"    | slider                     | from Expert  |
| "AI CrossSelling: Raster"          | fixed arrangement (grid)   | from Expert  |
| "AI CrossSelling: Liste"           | fixed arrangement (list)   | from Expert  |
| "AI CrossSelling: Mosaik"          | fixed arrangement (mosaic) | from Expert  |
| "AI CrossSelling: Spotlight"       | fixed arrangement          | from Expert  |

The element names are German in the English Administration too. All element settings are described on the page about Shopping Experiences elements.

**Narrow spaces:** If you place the standard cards in a narrow area, for example in the buy box next to the image gallery, the shop shows smaller cards at a width of 420 to just under 720 px, three per view. On phones the normal display stays.

Two more elements belong on the product page: the "Cogi Bundle/Set Configurator" for sets (from Expert, product pages only) and the "Cogi Conversion Booster Overlay" (from Advanced).

## What your customers see

### Loading and empty results

Recommendations are loaded in the browser afterwards. Until then, a short loading note appears ("Loading recommendations..."). This keeps the product page itself fast.

If there are no recommendations, the block disappears completely. No empty area and no notice text remain. To make this rare, you can set a fallback in the template (field "Fallback type").

### The product itself and its variants are never recommended

The product being viewed and its parent product are always excluded. Customers will not see another colour or size of the same item as a "recommendation". In addition, the template offers these switches (expert mode):

| Setting                    | Effect                                                                                                              | Default |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------- |
| "Disallow identical title" | Removes products whose title exactly matches the reference product.                                                 | on      |
| "Prefer same category"     | Gives higher weight to matches from the same category.                                                              | off     |
| "Exclude cart products"    | Also excludes products that are already in the cart (including variants) on product pages and shopping experiences. | off     |

"Fixed products" from the template always come first and count towards the limit. The exclusions apply to them as well.

### Adding to the cart from a recommendation

The template defines which button appears on the card (field "Button action"). In the element on the product page there are two options:

* "Show details": the button leads to the product page of the recommendation.
* "Add to cart": one item is added to the cart, then the offcanvas cart opens.

The third option "Details + cart" only works in the offcanvas cart and on the cart page. In Shopping Experiences elements, "Show details" is used instead.

Clicking the image or product name always leads to the product page.

**Products with variants:** Instead of adding any variant, the button then reads "Choose variant". It opens a window with the variant selection and the buy area of the product page.

**Products with a configurator:** For Printess, Custom Products and custom configurator plugins there are separate cards in the plugin configuration:

| Card                                 | Setting                                                                                                                 | Default               |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- | --------------------- |
| "Printess"                           | "Support Printess products": products with a Printess template show "Design now" and open the editor.                   | on                    |
| "Printess"                           | "Open the editor in a modal": the customer stays on the page and designs in a window.                                   | on                    |
| "Custom Products"                    | "Support Custom Products": such products are never added to the cart directly.                                          | on                    |
| "Custom Products"                    | "Button on the recommendation tile": "Link "View product"", "Link with the regular details label" or "Hide the button". | "Link "View product"" |
| "Custom configurator (custom build)" | "Support a custom configurator plugin": detection through the custom fields and CSS selectors you enter there.          | off                   |

If an editor cannot be started, the customer is sent to the product page and sees the note "This product has to be personalised on the product page."

Every product added to the cart from a recommendation is marked as such. This lets the statistics attribute revenue to recommendations.

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-257686381e056bda8b9eb09a638bd5e2c963be84%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-shop-produktseite-slider.png?alt=media" alt="Product page in the shop with the recommendation slider"><figcaption></figcaption></figure>

## Plan limits and locked elements

If the recommendation type of the template or the layout of the element is not included in your plan, the shop shows nothing in this place, without any notice for your customers. In the Shopping Experiences editor you can see this on the element: "Not displayed · Available from …" with the link "View plans".

## Frequently asked questions

<details>

<summary>The block does not appear on the product page at all.</summary>

Check in this order: Is the layout with the element assigned to the product? Is a template selected in the element? Are the type and layout included in your plan? Does the template return results for this product in the preview? Without results, the block is hidden on purpose.

</details>

<details>

<summary>Only similar products appear, no accessories.</summary>

"Similar products (alternatives)" mainly works with product properties. Real accessories come from order data ("Goes well with"), from rules in the template, for example a different category, or from the preset "Accessories (product page)".

</details>

<details>

<summary>Does the card show the customer-specific price?</summary>

By default, the card shows the price your shop sent to InsightSearch. If you turn on "Show live prices from Shopware" in the plugin configuration (default off), the shop loads the real, customer-specific price. More on the page about images, prices and fallbacks.

</details>

## 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/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/vqIfuf09tAiEW3Hoc7Ya" %}
[Images, prices and fallbacks](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/images-prices-and-fallbacks.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/product-page.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.
