> 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/search-intelligent-and-ai-optimized/settings.md).

# Settings

Layout of the plugin dashboard with sidebar, overview, header bar and plugin configuration.

The plugin dashboard is the control center of the search. Here you see whether everything works, import product data, maintain synonyms and filters and open the statistics. This page shows where to find what.

## Where do I find the plugin dashboard?

Open the Shopware administration and go to **Content → InsightSearch** in the left menu. In the German administration the entry is called "KI-gestützte Produktsuche".

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-09eaf6e99d24b8ad579d33cd90b3af8e8f8d956b%2Fsuche-intelligent-und-ki-optimiert-dashboard-uebersicht.png?alt=media" alt="Plugin dashboard with sidebar and system status in the overview"><figcaption></figcaption></figure>

Who may see and change the pages is described on the "Permissions" page.

{% content-ref url="/pages/UbPgPTIvpH80zt0F5BMB" %}
[Permissions](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/permissions.md)
{% endcontent-ref %}

## The sidebar

The "Navigation" sidebar is on the left. The "Collapse sidebar" button reduces it to icons, and your browser remembers the choice. During the initial setup the sidebar is hidden. Areas with new features temporarily carry the label "New".

| Group           | Area                                                                                                                                      | Purpose                                                                                  |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| Overview        | [Overview](#the-overview)                                                                                                                 | System status, quota and open problems. The number of open problems is shown next to it. |
| Overview        | [Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/statistics.md)                 | Search requests, clicks and revenue through the search.                                  |
| Products & data | [Products](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/products-in-the-dashboard.md)    | View products in the dashboard and maintain search term rules.                           |
| Products & data | [Sources](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/indices.md)                       | Create, re-import and delete data sources.                                               |
| Products & data | [Data attributes](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/data-attributes.md)       | Switch fields on or off and set their weighting.                                         |
| Products & data | [AI](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/ai-features.md)                        | The AI features and their status.                                                        |
| Search          | [Synonyms](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/synonyms.md)                     | Define terms with the same meaning.                                                      |
| Search          | [Filters](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/filters.md)                       | Decide which filters your customers see.                                                 |
| Search          | [Shopping assistant](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/shopping-assistant.md) | Set up the beta consultation in the shop.                                                |
| System          | [Settings](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/general-settings.md)             | Language assignment and subtitle.                                                        |
| System          | [Plugin configuration](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/plugin-settings.md)  | Opens the Shopware configuration page of the plugin.                                     |

## The overview

The overview is the starting point and is laid out from top to bottom.

**Notes above the cards.** If your search indices were deleted because of inactivity, a dismissible warning appears. It asks you to start a new indexing run. A message banner also shows current disruptions and planned maintenance. Each message has a title, a status ("Open", "In progress" or "Under observation"), the creation date and a description. Without messages the banner does not appear. On the Shopware dashboard you can switch it off in the plugin configuration.

**"System status" card.**

* **Connection:** "Connected" (green) or "Not connected" (red).
* **Data sources:** How many data sources exist. The "View data sources" button takes you to the sources.
* **Running processes:** If a push indexing run is active, you see a progress bar. If AI preparation is being prepared, it states for how many indices. Otherwise "No running processes" appears.
* **Missing language assignment:** If data sources exist but not a single assignment to a language and sales channel, a yellow warning appears: without an assignment the search is not shown in the shop. The "Assign languages" button jumps straight to the settings.

**"Search requests this month" card.** A bar shows the search requests so far in relation to the limit of your package. Up to 80 % the bar has its normal color, from 80 % it turns yellow, from 95 % red. Below it you see the "Forecast until end of month", an estimate based on the course of the month so far. Reaching the limit causes no restriction and no automatic extra costs. If the limit is clearly exceeded, we will get in touch with you.

**"Open problems" card.** Problems are listed with message text, affected data source and time. "Mark as resolved" removes a problem from the list. If there are none, it says "No open problems at the moment."

## The header bar

Three buttons are at the top right of the plugin dashboard.

* **Feedback:** Opens the feature board. It lists planned features with their status ("Idea", "Soon in progress", "In progress", "Released"). You vote with "For" or "Against"; the more votes, the higher the priority. Clicking your choice again withdraws the vote. You can also leave a comment, one per feature and user, and delete your own comment again.
* **News:** A bell with the number of unread entries (from ten on "9+"). The "News in InsightSearch" dialog can be filtered by "Features", "Improvements" and "Bug fixes". "Go to feature" jumps to the matching area and briefly highlights the spot. At the bottom you can "Mark all as read" or "Show news again".
* **Support:** Opens the "How can we help you?" dialog with up to three cards: "Onboarding" (a personal 30-minute appointment, available in the first three months after installation), "Support" with the "Technical support" button and "Documentation".

{% hint style="info" %}
You switch off the "New" labels and the counter in the plugin configuration, in the "Admin dashboard" card, with "Show news in the admin". The news stay available through the button.
{% endhint %}

## Plugin configuration

Open the configuration through "Plugin configuration" in the sidebar, or in Shopware through Extensions → My extensions → Plugin → Configuration. On the left is an "Areas" list that jumps to every card. "Expand all" and "Collapse all" arrange the cards. As usual in Shopware you can switch between "All Sales Channels" and a single channel at the top. A value set for "All Sales Channels" applies to every channel that does not override it.

You test the connection to InsightSearch in the "Global settings" card with "Test connection". The individual settings are explained on their own pages.

{% content-ref url="/pages/v20EC98NJrD47BUleH4w" %}
[Plugin settings](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/plugin-settings.md)
{% endcontent-ref %}

## Tile on the Shopware dashboard

On the start page of the Shopware administration, an "InsightSearch Suche" tile can show the most important figures. It only appears for users who may view orders and can be adjusted in the plugin configuration. You will find more under statistics.

{% content-ref url="/pages/HsFAOG9ZITzp3esXXRtx" %}
[Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/statistics.md)
{% endcontent-ref %}

## Further reading

{% content-ref url="/pages/UKhMX3Zla832boJXFREa" %}
[Sources](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/indices.md)
{% endcontent-ref %}

{% content-ref url="/pages/aMfV4gWX34ThmeivNqiQ" %}
[General settings](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/general-settings.md)
{% endcontent-ref %}

{% content-ref url="/pages/wSe62PjPXaI2JZoT2rqj" %}
[Feedback, support and cogi Commander](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/feedback-and-commander.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/search-intelligent-and-ai-optimized/settings.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.
