> 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/requirements-and-plans.md).

# Requirements and plans

What your shop needs for Cross Selling Pro and which features, recommendation types and quotas are included in the plans Basic to Enterprise.

Before you set up Cross Selling Pro, take a quick look at the technical requirements. Most shops already meet them; what matters most is Shopware's background processing and a reachable product feed. The second part of this page shows what each plan includes and how your request quota is counted.

## Versions

| Plugin version        | Shopware version        |
| --------------------- | ----------------------- |
| 2.x (currently 2.2.1) | Shopware 6.7            |
| 1.x (currently 1.4.1) | Shopware 6.6 from 6.6.9 |

Both version lines have the same features. The plugin does not require a specific PHP version; the system requirements of your Shopware version apply. The Shopware Storefront is required, because recommendations and tracking run there.

You do not need the InsightSearch search plugin. If you use both plugins, they work together (see [Working with InsightSearch, cogi Commander and other plugins](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/working-with-other-plugins.md)).

## What must run in your shop

### Background processing

The plugin handles many tasks in the background: sending cart, order and page view events to InsightSearch, transferring payment status, transferring past orders, sending push batches. For this, Shopware's background processing must run permanently, including the low-priority queue that carries the tracking.

{% hint style="warning" %}
Shopware's admin worker only works while an Administration window is open. For live shops, background processing should run as a service on the server. The exact command is in [Technical operation](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/technical-operation.md). If tracking events wait for more than 24 hours, the plugin dashboard shows a notice.
{% endhint %}

### Scheduled tasks

Shopware's scheduled tasks must run. Through them the plugin checks the connection and your plan every hour, reconciles orders at night and regenerates the product export for the feed. Without scheduled tasks the feed becomes outdated and plan changes do not arrive.

### Product data for InsightSearch

InsightSearch needs your product data to calculate recommendations. The setup wizard sets this up:

* **Product feed (pull, standard for live shops):** the wizard creates a sales channel of the type "Product comparison" with a product export. InsightSearch fetches this feed. The feed address must be **public and reachable without login**. Password protection, IP blocks or bot protection in front of the shop prevent the download.
* **Push:** the plugin sends the products itself. Push is intended for DEV and staging environments that cannot be reached from outside.

More in [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).

### Your visitors' browsers

Recommendations are fetched from InsightSearch directly in your visitors' browsers. Therefore check:

* A strict Content Security Policy in your shop must allow connections to InsightSearch.
* A web application firewall or bot protection must not block the plugin's shop routes (access key, product data, live prices, visibility check).
* Ad blockers of individual visitors can suppress recommendations. You cannot influence this.

### Shopware account and in-app purchases

You book plans through the Shopware in-app purchase. Your shop must be connected to your Shopware account for this.

### Theme

The plugin brings its own styling for sliders, off-canvas cart, bundle/set and Conversion Booster, including adjustments for Zenit themes. After installing or updating, the theme must be compiled again so that the styling applies.

## The plans

Cross Selling Pro is available in five plans: **Basic**, **Starter**, **Expert**, **Advanced** and **Enterprise**. You find your plan in the plugin dashboard under **System → Plans** in the "Plans & Features" card with the line "Your current plan". There you compare the plans. The "Buy" button opens the Shopware in-app purchase.

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-383c14848c9551212912299059888d43c7868086%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-pakete.png?alt=media" alt="Plans section with the feature comparison table"><figcaption></figcaption></figure>

### Request quota

| Plan       | Requests per calendar month |
| ---------- | --------------------------- |
| Basic      | 100,000                     |
| Starter    | 500,000                     |
| Expert     | 1,000,000                   |
| Advanced   | 5,000,000                   |
| Enterprise | unlimited                   |

**What counts as a request:** every recommendation block loaded in the shop is one request, even if it finds no products. Milestone recommendations in the cart count as an additional request. The preview in the template form and the sandbox do not count.

**What happens when the limit is reached:** only the Basic plan stops showing recommendations until the end of the month. For paid plans the limit is a guideline without restrictions or automatic extra costs. If you exceed it considerably, InsightSearch will get in touch with you to find a solution together.

You see your usage under **Overview → Overview** in the "Monthly request quota" card with "Current requests" and "Projected end-of-month".

### Recommendation types per plan

| From plan | Recommendation types                                                                |
| --------- | ----------------------------------------------------------------------------------- |
| Basic     | Similar products, Recently viewed                                                   |
| Starter   | plus Bestsellers, Buy again, recommendations for a search term in the search plugin |
| Expert    | plus Trends, Personal, Goes well with, Continue where you left off, Wishlist        |

What the types do is described in [Recommendation types](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/recommendation-types.md).

### Card layouts per plan

| From plan | Layouts                                                                                                 |
| --------- | ------------------------------------------------------------------------------------------------------- |
| Basic     | "Classic (type-1)", "Minimal (type-4)"                                                                  |
| Starter   | plus "Compact horizontal (type-2)", "Wide horizontal (type-3)"                                          |
| Expert    | plus "Grid (type-5)", "Grid static (type-6)", "List (type-7)", "Masonry (type-8)", "Spotlight (type-9)" |

Examples of the layouts are in [Shopping Experience elements and card layouts](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/shopping-experience-elements.md).

### Features per plan

| From plan | Features                                                                                                                                           |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Starter   | "Offcanvas / cart recommendations", "Cart recommendations", "Fixed products", revenue tracking, click rate statistics, "Milestone recommendations" |
| Expert    | "Rule builder", "Accessory element (bundle set)", "Full statistics", "Customer account recommendations", "Milestone recommendations with AI"       |
| Advanced  | "Conversion booster"                                                                                                                               |

On the cart page, the grid and list displays are available from Expert; before that, a slider is used. The checkout interstitial page has no plan restriction.

### How to recognise locked features

* **Notice card** with a lock, "Available from …" and the "Compare plans" button, for example for a locked recommendation type or placement.
* **Overlay:** the content is blurred underneath, on top it says "More recommendations, more revenue.", for example for fixed products, the rule builder or statistics.
* **Lock in selection lists:** locked options show the lock and the plan name.
* **In Shopping Experiences:** an element your plan does not include shows "Not displayed · Available from …" with the link "View plans" in the editor.
* **Green badge:** "Included in the … plan" shows that a feature is unlocked in your plan.

## Changing your plan

1. In the plugin dashboard, open **System → Plans**.
2. Click "Buy" for the plan you want.
3. Complete the purchase in the Shopware in-app purchase.

After the purchase in the Administration the new plan applies immediately. In addition, the plugin checks your plan with Shopware every hour, even without an open Administration. A paid plan is only downgraded if the purchase cannot be found several times in a row. A short disruption therefore does not downgrade you.

## Read more

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