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

# The plugin dashboard

Layout of the Cross Selling Pro plugin dashboard: sidebar, sections, notices and required permissions.

The plugin dashboard is where you control Cross Selling Pro: status, templates, placements, data sources, statistics and plans. This page explains where to find what. Each feature is described in detail on its own page.

Open the dashboard via **Content → InsightSearch**. As long as the initial setup is not finished, the [setup wizard](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/setup-wizard-connection.md) appears there instead.

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

## Buttons at the top right

| Button         | Effect                                                                                                                                                                                                 |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| "Feedback"     | Opens the "Feature Board". There you see planned features, vote with "Upvote" or "Downvote" and leave a comment.                                                                                       |
| "News"         | Bell with the number of unread news items, see below.                                                                                                                                                  |
| "Support"      | Opens the window "How can we help you?", see below.                                                                                                                                                    |
| "Setup wizard" | Starts the [configuration assistant](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/configuration-assistant.md) for new templates. |

## The sidebar

On the left is the sidebar with four groups. "Collapse sidebar" makes it narrow; the state is remembered in the browser.

| Group           | Item                       | What you find there                                                                                                                                                       |
| --------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Overview        | "Overview"                 | System status, request quota, open problems. A number on the item shows open problems.                                                                                    |
|                 | "Statistics"               | Revenue, orders, click rates and trends per recommendation.                                                                                                               |
|                 | "CMS blocks"               | All recommendation blocks in your Shopping Experiences with key figures.                                                                                                  |
|                 | "User tracking"            | Visitor journeys (searches, clicks, purchases) that personal recommendations are based on.                                                                                |
| Delivery        | "Placements"               | Recommendations in the offcanvas, in the cart, in the customer account, on the checkout interstitial page and as milestones. The sub-items jump straight to each section. |
|                 | "Recommendation templates" | List, creation and editing of your templates.                                                                                                                             |
|                 | "Bundle/set templates"     | Templates for bundles and sets.                                                                                                                                           |
| Products & data | "Products"                 | The recommendation sandbox for trying out templates.                                                                                                                      |
|                 | "Sources"                  | Your data sources (feeds or push) with key figures and actions.                                                                                                           |
|                 | "Data fields"              | Which product fields filters, rules and similarity may use.                                                                                                               |
|                 | "AI"                       | Settings for the AI features.                                                                                                                                             |
| System          | "Settings"                 | Assignment of data sources to sales channels and languages.                                                                                                               |
|                 | "Plugin configuration"     | Leads to the Shopware plugin configuration (live prices, visibility, tracking and more).                                                                                  |
|                 | "Plans"                    | Your current plan and a comparison of all plans.                                                                                                                          |

New features carry a "New" label in the sidebar. It disappears once you have visited the section.

## Notices above the content

Notices may appear above the content:

* **"Current Notices":** current disruptions and planned maintenance, with the status "Open", "In progress" or "Under observation". This only appears when there are notices.
* **Indices deleted:** "Your recommendation indices were deleted due to inactivity." Start a new indexing run under "Sources" and the recommendations work again.
* **Tracking events waiting:** cart, order and page view events have been waiting for background processing for more than 24 hours. The notice names the required command. See [Technical operation](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/technical-operation.md).

## The sections in detail

### Overview

| Card                    | Content                                                                                                                                                                                                                                                                                       |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "System status"         | "Connection" ("Connected" or "Not connected"), number of data sources, running operations such as "Push indexing running" or AI preparation. If languages and sales channels are not assigned yet, a warning with "Assign languages" appears.                                                 |
| "Monthly request quota" | "Current requests" in the current month against your plan's limit, plus "Projected end-of-month". Details on the page [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). |
| "Open problems"         | Problems detected by InsightSearch per index. "Mark as resolved" closes an entry.                                                                                                                                                                                                             |

If there is no template yet, a notice about the setup wizard appears above the cards.

### Statistics, CMS blocks and user tracking

{% hint style="info" %}
Full statistics are available from plan Expert.
{% endhint %}

The statistics show revenue, orders, click rates and trends per recommendation. Without plan Expert, a notice appears instead of the figures. Everything about this is on the page [Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/statistics.md).

### Products (recommendation sandbox)

Here you try templates or recommendation types on a source product and compare two settings side by side. The sandbox saves nothing and changes nothing in the shop. 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).

### Sources

Under "Available data sources" you see each data source with "Language", "Currency", "Products", "Last index run", "Next index run" and "Mode" (pull or push), plus a status such as "Ready", "Sync in progress" or "Failed".

| Button or field             | Effect                                                                |
| --------------------------- | --------------------------------------------------------------------- |
| "Refresh"                   | Only reloads the display.                                             |
| "Reindex"                   | Starts a full re-indexing.                                            |
| "Edit data fields"          | Opens the editor for this source's fields.                            |
| "Delete"                    | Deletes the data source after confirmation.                           |
| "Add product feed"          | Adds another feed, for example for another sales channel or language. |
| "Automatic indexing (time)" | Daily time for fetching. Starts within 15 minutes after it.           |

With push you see the progress and can cancel or restart a running indexing.

Two more tools help with gaps in the statistics:

* **Transfer missing orders:** if there are orders that have not been transferred yet, the dashboard shows how many. "Sync" transfers them afterwards.
* **"Recalculate payment status":** if you change in the plugin configuration which payment states count as paid, the orders of the last 90 days are re-evaluated automatically. This button starts it manually.

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-ce13911b375a58bfd2bdb3a24a4673d313b5442b%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-indizes.png?alt=media" alt="Sources section with data source, key figures and automatic indexing"><figcaption></figcaption></figure>

### Data fields and AI

Under "Data fields" you decide which product fields InsightSearch may use for filters, rules and similarity. See [Data fields](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/data-fields.md). Under "AI" you find the settings for the AI features. Product type detection is a beta feature that InsightSearch unlocks for you.

### Settings (language assignment)

In the card "Assigned languages" you assign each "Product index" its "Assigned sales channels" and "Assigned languages". Every combination of sales channel and language needs exactly one data source, otherwise no recommendations are shown there. A combination may only be assigned to one data source.

### Plans

"Plans & Features" shows your current plan and compares all plans by quota, recommendation types, layouts and features. "Buy" lets you purchase a plan via Shopware in-app purchase. See [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).

## News and support

**News:** the window "What's new in InsightSearch Recommendations" lists new features, improvements and bug fixes. Each entry can take you straight to the matching place. In the plugin configuration, the switch "Show news in the admin" turns off the counter and the "New" labels.

**Support:** the window "How can we help you?" offers up to three tiles:

* "Onboarding": during the first three months after installation, "Book a call" lets you book a personal 30-minute call about the setup.
* "Support": "Technical support" for questions and problems.
* "Documentation": "Go to documentation" leads to this documentation.

## Required permissions

Cross Selling Pro does not add its own roles; it uses existing Shopware permissions.

| Area                                                                                                                        | Required permission              |
| --------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Statistics, CMS blocks, user tracking, product statistics, tile on the Shopware dashboard                                   | Viewing orders                   |
| Changing actions (add feed, reindex, delete, language assignment, data fields, time, push, transfer orders, payment status) | Editing the system configuration |
| Viewing and changing "Placements"                                                                                           | Managing extensions              |

{% hint style="info" %}
The sidebar shows all items regardless of permissions. If a permission is missing, Shopware blocks the section when you open it.
{% endhint %}

## Read more

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

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