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

# Search - Intelligent and AI Optimized

Overview of the plugin "Search - Intelligent and AI Optimized", its features and a guide through the documentation.

Take your product search and your cross-selling to the next level: this plugin delivers a **fast, precise and AI-optimized search**, combined with **intelligent product recommendations** that fit your customers and your range.

{% embed url="<https://store.shopware.com/de/cogi508535609443m/suche-intelligent-und-ki-optimiert.html>" %}

### Why this plugin?

Many standard searches are purely keyword-based: typos, colloquial terms or different spellings quickly lead to inaccurate results. **Our search understands queries the way customers phrase them** and helps them find the right product faster. At the same time, the AI recognizes which products belong together and shows matching recommendations, automatically.

### Highlights at a glance

#### AI-powered search that "thinks along"

* **Semantic search:** Recognizes meaning instead of just words.
* **Better result quality:** Even with synonyms, variants and "customer language".
* **Fast results:** For a smooth shopping experience and fewer bounces.
* **Help with zero results:** Typo correction, a relaxed search and matching alternative products instead of an empty page.
* **Your own control:** You decide on synonyms, search term rules and the weighting of product fields.
* **Own design for mobile:** Four designs for small screens, selectable per sales channel.
* **Shopping assistant (beta):** An advisor that guides customers to the right product with a few questions.

#### Recommendations that raise revenue potential

* **Automated cross-selling suggestions** based on products.
* **Higher cart value** through matching add-ons instead of random suggestions.

#### Numbers that show you what the search achieves

* **Statistics** with search queries, click-through rate, searches without results and revenue via the search.
* **Tile in the Shopware dashboard** with the most important key figures at a glance.
* **"Lost opportunities" list:** turn searches that lead nowhere into synonyms and rules with one click.

### Recommendations as a flexible CMS element

Add recommendations **as a CMS element wherever they work best**, for example on:

* Product detail pages (for example "Goes well with")
* Category pages
* Landing pages and campaign pages

This lets you place cross-selling exactly where you want it, without extensive maintenance.

{% hint style="info" %}
The block "AI Basis Empfehlungsslider" is marked as deprecated and keeps working. For new pages we recommend the plugin "Cross-Selling Pro - KI Cross Selling". If it is connected in the same shop, the search overlay additionally shows "Goes with" and matching alternative products for searches without results. More under [Shopping Experiences and recommendations](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/cms-elements-and-recommendations.md).
{% endhint %}

### Easy start, no additional subscriptions

* **No external accounts required**
* **No additional subscriptions required**
* **Everything can be managed directly in Shopware**
* Simple setup with a wizard
* Setup support on request for a fast go-live

### Your benefits

* **Higher revenue** through better search and targeted cross-selling
* **Higher conversion rate** through more relevant results and recommendations
* **Less manual work:** Recommendations are created automatically
* **Better user experience:** Customers find what they actually mean faster
* **GDPR-compliant** (privacy-conscious implementation with a focus on secure processing), details under [Data protection](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/data-protection.md)

## Features at a glance

| Feature                   | What it does                                                                        | More                                                                                                                                                 |
| ------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search window in the shop | Suggestions, results, filters and product cards right while typing                  | [Search in the shop](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-in-the-shop.md)            |
| No results                | Typo correction, relaxed search, alternative products, your own shopping experience | [No results](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/no-results.md)                            |
| Search results page       | Shopware's results page with results and order from InsightSearch                   | [Search results page](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-results-page.md)          |
| Search on mobile          | Four selectable designs, list or two-column grid, filters from the bottom           | [Search on mobile](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-on-mobile.md)                |
| Synonyms                  | Link different words for the same product                                           | [Synonyms](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/synonyms.md)                                |
| Filters                   | Narrow down by brand, price, colour and more, also as a slider                      | [Filters](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/filters.md)                                  |
| Data attributes           | Define how strongly each product field counts for the ranking                       | [Data attributes](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/data-attributes.md)                  |
| Search term rules         | Pin, hide, boost or lower results, redirect, show banners                           | [Search term rules](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-term-rules.md)              |
| AI features               | Hybrid search, synonym suggestions, analysis                                        | [AI features](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/ai-features.md)                          |
| Statistics                | Key figures, search terms, revenue via search, CSV export                           | [Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/statistics.md)                            |
| Shopping assistant (beta) | Advice in a question and answer style                                               | [Shopping assistant](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/shopping-assistant.md)            |
| Live synchronisation      | Price and stock changes in the search after about two minutes                       | [Push and live synchronisation](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/push-and-live-sync.md) |
| Design                    | Colours, stylesheet, rounded corners, placeholder texts                             | [Customize design](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/customize-design.md)                |

## Where do I start?

| I want to …                                      | These pages help                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| install and set up the plugin                    | [Requirements](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/requirements.md), [Installation and setup](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/installation-and-setup.md), [Getting started](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/getting-started.md)                                                                                                                               |
| get better results                               | [Synonyms](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/synonyms.md), [Data attributes](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/data-attributes.md), [Search term rules](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-term-rules.md), [Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/statistics.md)                      |
| adapt the search to our shop                     | [Plugin settings](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/plugin-settings.md), [Customize design](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/customize-design.md), [Search on mobile](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-on-mobile.md)                                                                                                                                   |
| know what the search achieves                    | [Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/statistics.md), [Feedback, support and cogi Commander](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/feedback-and-commander.md)                                                                                                                                                                                                                                                          |
| solve a problem                                  | [Troubleshooting](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/troubleshooting.md), [FAQ and common problems](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/faq-and-common-problems.md)                                                                                                                                                                                                                                                            |
| understand stage, push and commands as an agency | [Stage and live](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/stage-and-live.md), [Push and live synchronisation](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/push-and-live-sync.md), [Commands](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/commands.md), [Data protection](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/data-protection.md) |
| look up terms                                    | [Glossary](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/glossary.md)                                                                                                                                                                                                                                                                                                                                                                                                                               |

## The documentation at a glance

**Getting started**

* [How the search works](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/introduction.md)
* [Requirements](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/requirements.md)
* [Installation and setup](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/installation-and-setup.md)
* [Getting started](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/getting-started.md)
* [Glossary](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/glossary.md)

**Set up and maintain in the plugin dashboard**

* [Settings overview](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/settings.md)
* [Sources](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/indices.md)
* [General settings](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/general-settings.md) (language assignment, subtitle)
* [Edit data fields](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/feed-template-editor.md)
* [Data attributes](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/data-attributes.md)
* [Synonyms](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/synonyms.md)
* [Filters](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/filters.md)
* [Search term rules](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-term-rules.md)
* [Products in the dashboard](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/products-in-the-dashboard.md)
* [AI features](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/ai-features.md)
* [Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/statistics.md)
* [Permissions](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/permissions.md)

**Plugin configuration**

* [Plugin settings](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/plugin-settings.md)
* [More configuration cards](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/more-configuration.md)

**Search in the shop**

* [Search in the shop](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-in-the-shop.md)
* [No results](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/no-results.md)
* [Search results page](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-results-page.md)
* [Search on mobile](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-on-mobile.md)
* [Customize design](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/customize-design.md)

**Additional features**

* [Shopping assistant (beta)](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/shopping-assistant.md)
* [Shopping Experiences and recommendations](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/cms-elements-and-recommendations.md)
* [Feedback, support and cogi Commander](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/feedback-and-commander.md)

**Operation and help**

* [Push and live synchronisation](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/push-and-live-sync.md)
* [Stage and live](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/stage-and-live.md)
* [Data protection](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/data-protection.md)
* [Commands](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/commands.md)
* [Troubleshooting](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/troubleshooting.md)
* [FAQ and common problems](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/faq-and-common-problems.md)

## Versions

The plugin is released in two version lines with the same feature set: **2.x for Shopware 6.7** and **1.x for Shopware 6.6**. This documentation applies to both. Details under [Requirements](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/requirements.md).


---

# 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.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.
