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

# Installation

How to install, update and remove Cross Selling Pro in your Shopware shop.

On this page you install Cross Selling Pro and prepare your shop for the setup. After that come the setup wizard (connection and product data) and, if you like, the setup assistant for your first templates. You will also learn what happens during an update and when you uninstall the plugin.

## Before you start

| What                        | Requirement                                                                                                             |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Shopware 6.7                | Plugin version 2.x (Shopware 6.7.0.0 up to below 6.8)                                                                   |
| Shopware 6.6                | Plugin version 1.x (from Shopware 6.6.9.0)                                                                              |
| Storefront                  | Required. Recommendations, tracking and the cookie notice run through the Shopware Storefront.                          |
| Background processing       | Shopware's background processing and scheduled tasks must run continuously.                                             |
| InsightSearch search plugin | Not required. Cross Selling Pro works on its own. Together with the search plugin you get additional combined features. |

Both version lines offer the same features. The plugin does not require a specific PHP version; the system requirements of your Shopware version apply.

{% hint style="warning" %}
Without background processing, cart and order events do not reach InsightSearch, and product transfer via push stops. For live shops, a permanently running service is recommended instead of the admin worker. See [Technical operation](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/technical-operation.md) for details.
{% endhint %}

## Install the plugin

{% stepper %}
{% step %}

### Get the plugin

In the Shopware Administration, open **Extensions → Store** and search for **Cross Selling Pro | KI + Warenkorb Cross-Selling + Bundles & Sets**. Purchase or download the plugin.
{% endstep %}

{% step %}

### Install and activate

Go to **Extensions → My extensions**. Click **Install** for the plugin and then **Activate**. In the list, the plugin appears as "InsightSearch - AI-Powered Cross-Selling".

During installation, the plugin registers with InsightSearch and receives an installation key. If this does not work right away (for example without an internet connection), the installation still stays in place. You then complete the registration in the setup wizard.
{% endstep %}

{% step %}

### Open the setup wizard

Open **Content → InsightSearch**. As long as the setup is not finished, the plugin shows the setup wizard there with the title "Initial setup".

Alternatively, open **Configure** for the plugin in **My extensions**. At the top you will see the notice "Info: For a fresh installation, run the installation wizard first." with the button "Open installation wizard". Next to it, "Test connection" checks whether the shop can reach InsightSearch.
{% endstep %}
{% endstepper %}

## The path to a working setup

The initial setup has two parts, a third one is optional:

1. **Setup wizard, connection:** you create an InsightSearch installation for this shop. See [Setup wizard: connection](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/setup-wizard-connection.md).
2. **Setup wizard, product data:** you connect your products to InsightSearch, usually through a product feed. 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).
3. **Setup assistant (optional):** it guides you through creating your first recommendation templates. See [Configuration assistant](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/configuration-assistant.md).

{% hint style="info" %}
If you prefer, InsightSearch can handle the initial setup for a one-time setup fee. Get in touch via the Shopware ticket system. The setup wizard also shows a note about this at the top.
{% endhint %}

## Several environments (live, stage, development)

Create a separate InsightSearch installation for each environment: one for production, one for staging and one for development. This keeps recommendations, statistics and data of the environments apart.

Stage and test systems are often protected by a password or IP restriction. InsightSearch cannot fetch the product feed there. Allow access to the feed or choose the indexing type Push for that environment.

If the shop has already been connected to InsightSearch before (for example a copy of the live shop), the platform may refuse a new registration. In that case, allow the re-registration in your InsightSearch account under installations.

## Update the plugin

Install updates as usual via **Extensions → My extensions**. Shopware runs any new database changes on its own.

After an update it helps to recompile the theme, clear the shop cache and restart running workers so they load the new code. These are standard Shopware steps your agency will know.

<details>

<summary>Notes on updating to 2.2.1 or 1.4.1</summary>

* The first time you save the plugin configuration after the update, a one-time recalculation of the orders' payment status starts.
* From the update on, visitor sessions are counted under a new identifier. Statistics may therefore show a jump on the day of the update.
* Availability and main category of products take effect with the next transfer of product data.

</details>

## Deactivate the plugin

When you deactivate the plugin, it signs off from InsightSearch. No recommendations appear in the shop anymore, and the plugin's tracking and scheduled tasks pause. Your templates and settings are kept. When you activate it again, the plugin signs back on.

## Uninstall the plugin

When uninstalling, Shopware asks whether the plugin data should be kept. This decides what remains.

| Choice           | What happens                                                                                                                                                           |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Keep data        | Templates, settings and credentials stay in the shop. A later reinstallation connects without a new registration.                                                      |
| Do not keep data | The plugin deletes all recommendation templates, all bundle/set templates, its settings and credentials, and all recommendation elements in your Shopping Experiences. |

{% hint style="danger" %}
If you do not keep the data, your Shopping Experiences permanently lose their recommendation blocks. After a reinstallation you will need to create templates and blocks again.
{% endhint %}

The sales channel of type "Product comparison", the dynamic product group and the product export created by the setup wizard are not deleted automatically. To remove everything, delete these three manually under **Sales Channels** and **Catalogues → Dynamic product groups**.

## Read more

{% content-ref url="/pages/l3C2MdrrPOR394W5umMD" %}
[Setup wizard: connection](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/setup-wizard-connection.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 %}

{% content-ref url="/pages/2ZVSAniefBU0WuizMlL8" %}
[Technical operation](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/technical-operation.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/installation.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.
