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

# Bundle and set templates

With bundle/set templates you build sets on the product page, so customers can add several items to the cart at once.

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

A bundle/set template defines which add-on products appear next to the main product on a product page and how customers select them. In the storefront, the element "Cogi Bundle/Set Configurator" shows the main product, the add-on products, a selection with the bundle price and a button that adds everything to the cart in one go. Typical uses are "Matching accessories", starter sets or "Frequently bought together".

The template itself is invisible. It only becomes visible once you place the element in a product page layout in your Shopping Experiences and select the template there.

## Creating a template

1. Open **Content → InsightSearch** and select **Delivery → Bundle/set templates** in the sidebar.
2. Click "Create template".
3. Fill in the cards "General", "Source" and "Recommendations" (fields see below).
4. Save the template.
5. Under **Content → Shopping Experiences**, open a layout of type product page and add the element "Cogi Bundle/Set Configurator" from the block category "AI CrossSelling".
6. In the element, select your template under "Set template". Optionally enter a "Title" and "Subtitle" shown above the set. If the title is empty, no heading appears.
7. Save the Shopping Experience and assign it to the products or categories you want.

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-ca7e237d6275d34245886031ba41f393b1b8e3a6%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-bundle-vorlage-bearbeiten.png?alt=media" alt="Bundle/set template form with the General, Source and Recommendations cards"><figcaption></figcaption></figure>

{% hint style="warning" %}
The element only works on product pages. Home pages, category pages and landing pages have no main product, so nothing is shown there.
{% endhint %}

Without the Expert plan, the button "Create template" is missing and the list sits under a notice "Bundle & set templates" with the button "Compare plans".

## Card "General"

| Setting       | Effect                                                                                  | Default |
| ------------- | --------------------------------------------------------------------------------------- | ------- |
| "Name"        | Internal name to identify the template in the admin. Customers do not see it. Required. | empty   |
| "Description" | Internal note, for example which products or pages the set is meant for.                | empty   |

## Card "Source"

Here you define where the add-on products come from. Depending on the selected source, matching fields appear below.

| Source                                   | Where the products come from                                                                                                  | Suitable for                                              |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| "Fixed products"                         | Products you select in the field "Fixed products". They always appear, no matter on which product page the element is placed. | Fixed offers, such as a care set for a whole product line |
| "Dynamic product stream"                 | All products that match the rules of the selected dynamic product stream.                                                     | Rule based sets, for example accessories of one brand     |
| "Cross-selling (from reference product)" | The Shopware cross-selling maintained on the product being viewed.                                                            | Shops that already maintain cross-sellings per product    |

Further fields on this card:

| Setting                                | Effect                                                                                                                                                                                               | Default                  |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| "Limit"                                | Maximum total number of product tiles, including recommendations used to fill up. Allowed values are 1 to 50.                                                                                        | 6                        |
| "Enable selection (checkboxes)"        | Customers tick the products they want and add them to the cart together.                                                                                                                             | on                       |
| "Include main product in total & cart" | Off: the main product does not count towards the bundle price and is not added to the cart. The cart button then only becomes active once at least one add-on product is selected.                   | on                       |
| "Show only available products"         | Removes products that cannot be ordered in the sales channel: inactive products and clearance sale items with too little stock. For the source "Dynamic product stream" this check is always active. | off                      |
| "Product view"                         | How customers can take a closer look at an add-on product without losing their selection: "None (selectable only)", "Open product page in a new tab" or "Open a preview in a dialog".                | "None (selectable only)" |
| "Fixed products"                       | Selection of products, only with the source "Fixed products".                                                                                                                                        | empty                    |
| "Dynamic product stream"               | Selection of the stream, only with the source "Dynamic product stream".                                                                                                                              | empty                    |
| "Cross-selling name"                   | Only with the cross-selling source. If a name is entered, the set uses the cross-selling with this name.                                                                                             | empty                    |
| "Cross-selling position"               | Only with the cross-selling source and only if no name is set: 1 is the first cross-selling by position.                                                                                             | 1                        |

{% hint style="info" %}
Note on stock: if "Clearance sale" is not enabled on a product, it stays in the set even at stock 0, because Shopware then deliberately allows overselling. The help text of the field says the same.
{% endhint %}

## Card "Recommendations"

If the source returns too few products, the set can be filled up automatically with recommendations.

| Setting                      | Effect                                                                                                                   | Default |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------- |
| "Enable fixed product count" | Fills empty slots with recommendations from a recommendation template.                                                   | off     |
| "Product count"              | The set is filled up to this number. Allowed values are 1 to 50. Only visible when the fixed product count is enabled.   | 6       |
| "Recommendation template"    | The recommendation template that supplies the additional products. Only visible when the fixed product count is enabled. | empty   |

An example: the source "Cross-selling" returns two products and "Product count" is set to 4. The selected recommendation template then adds two more products.

## What your customers see

* The tile of the current product carries the label "Your product", the add-on products are shown next to it.
* Below, the area "Selection" sums up the chosen items, with the "Bundle price" and the button "Add selection to cart".
* With checkboxes, **no** add-on product is ticked at the start. Without checkboxes, all products are selected.
* Each product lands in the cart as its own normal line item with quantity 1. The offcanvas cart then opens.
* Products that have to be designed first (for example Custom Products or Printess) cannot be selected in the set. The customer sees the notice "Personalisable. Please configure it on the product page."
* If the set finds no products, "No bundle products found." is shown.

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-36cc939412c62780de6e5867d7b81d732b72f7ee%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-shop-produktseite-bundle.png?alt=media" alt="Bundle/set configurator on the product page with selection and bundle price"><figcaption></figcaption></figure>

## Bundle price: no separate discount

The bundle price is the sum of the single prices of the selected products (one of each), plus the main product if it is included. **There is no separate set discount.** A crossed out price with a percentage only appears if the products have list prices in Shopware itself and their sum is higher than the bundle price.

If you switch on live prices in the plugin configuration, the set calculates with the prices the logged in customer actually pays in Shopware.

## Set template as the source of a recommendation template

A normal recommendation template can use "Bundle/Set template" as its source. Sliders, the offcanvas cart or the cart page then show the products of this set template as normal cards, without selection and bundle price. Filling up via the card "Recommendations" of the set template does not apply in this case.

## Statistics

Set orders are evaluated in the statistics as a separate area "Sets". The main product of a set does not count as revenue from recommendations, only the add-on products do.

## Tips to get started

| Setting                         | Suggestion                                                                       |
| ------------------------------- | -------------------------------------------------------------------------------- |
| Source                          | "Cross-selling (from reference product)", if you already maintain cross-sellings |
| "Enable selection (checkboxes)" | on                                                                               |
| "Limit"                         | 4                                                                                |
| "Enable fixed product count"    | on, with a template of type "Similar products" or "Goes well with"               |

You can create many cross-sellings at once with the quick assignment.

## 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/20SCHVlouw61zvak7CtT" %}
[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)
{% 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/bundle-and-set-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.
