> 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/faq-and-common-problems.md).

# FAQ and common problems

Answers to frequently asked questions about the search, with links to the pages that cover the topic in detail.

Here you find short answers to the questions that come up most often in everyday use, and the way to the page with all the details. If you want to solve a problem, start with [Troubleshooting](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/troubleshooting.md).

## Question and answer page

| Question                                                      | Answer page                                                                                                                                                       |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| How long does it take until changes are visible?              | [Troubleshooting](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/troubleshooting.md)                               |
| Why can't I find a product?                                   | [Troubleshooting](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/troubleshooting.md)                               |
| Can I configure the search per language?                      | [Language assignment](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/general-settings.md)                          |
| Why does the Shopware search appear instead of InsightSearch? | [Troubleshooting](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/troubleshooting.md)                               |
| Reading the product feed fails. What to do?                   | [Reading the product feed fails](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/reading-the-product-feed-fails.md) |
| How do I get a staging environment into the search?           | [Stage and Live](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/stage-and-live.md)                                 |
| Indexing stops at 96 percent                                  | [Push and live synchronisation](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/push-and-live-sync.md)              |
| What happens when the quota is reached?                       | [Troubleshooting](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/troubleshooting.md)                               |
| How are purchases attributed to the search?                   | [Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/statistics.md)                                         |
| Does the search need a cookie?                                | [Data protection](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/data-protection.md)                               |
| Which commands do I need as an agency?                        | [Commands](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/commands.md)                                             |

## Frequently asked questions

### How long does it take until changes are visible?

That depends on the way. With the pull feed, changes to a product appear after the next export run of Shopware and the next retrieval. With "Re-import product data" in the "Sources" area it works immediately. With push, live synchronisation brings changes into the search after about two minutes, otherwise the next push applies. Filter settings take effect after up to 5 minutes. The table is under [Troubleshooting](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/troubleshooting.md#changes-are-not-visible).

### Why can't I find a product?

Usually the product is inactive in Shopware, not visible in the sales channel or excluded by the filter of the dynamic product group. Also check whether you re-imported the product data after the change. You find the checklist under [Troubleshooting](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/troubleshooting.md#products-are-missing).

### Can I configure the search per language?

Yes. You assign a data source to each language of a sales channel. The assignment applies exactly to this combination of sales channel and language. If it is missing, the Shopware search stays. Read [Language assignment and subtitles](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/general-settings.md).

### Why does the Shopware search appear instead of InsightSearch?

Either "Enable search" is off, or the assignment for the sales channel and the language is missing. A disruption on the server route also switches briefly to the Shopware search. The checks are under [Troubleshooting](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/troubleshooting.md#the-search-shows-shopware-results).

### Why does reading the feed fail?

Common causes are password protection, a firewall, maintenance mode or an empty product export. Our search system retrieves the feed over the internet, so it must be reachable without login. All error types are under [Reading the product feed fails](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/reading-the-product-feed-fails.md).

### How do I get a staging environment into the search?

Use the mode push for staging and development: the shop sends the products itself, the stage does not have to be reachable from outside. For this, Shopware's background processing must run permanently. More under [Stage and Live](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/stage-and-live.md) and [Push and live synchronisation](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/push-and-live-sync.md).

### Indexing stops at 96 percent. What to do?

Usually no worker is running, or it has too little memory. After a few minutes the plugin requeues stuck packages itself. If no worker runs at all, the run counts as failed after one hour and can be restarted. Check whether a worker is running, see [Push and live synchronisation](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/push-and-live-sync.md).

### What happens when the quota of search queries is reached?

When the limit is reached, there are no restrictions or automatic extra costs. In case of excessive overuse, we will contact you to find a solution together. The shopping assistant (beta) is hidden until the first of the month when the quota is used up. See [Troubleshooting](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/troubleshooting.md#quota-reached).

### How are purchases attributed to the search?

A purchase counts per purchased product (or its variant) as revenue via the search if this product was clicked in the search or put into the cart from there. Up to 72 hours may lie between the click and the order, in the same browser. More under [Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/statistics.md).

### Does the search need a cookie?

The plugin uses a cookie for recognition, but only after consent in the cookie banner. Without consent the search works anyway, there is just no recognition across several visits. Details and notes for your privacy policy are under [Data protection](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/data-protection.md).

## Further reading

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

{% content-ref url="/pages/b675qqwsZn7vseBK0dd9" %}
[Reading the product feed fails](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/reading-the-product-feed-fails.md)
{% endcontent-ref %}

{% content-ref url="/pages/kRomH0o5aBX5iDGMqpD3" %}
[Stage and live](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/stage-and-live.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/faq-and-common-problems.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.
