> 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/no-results.md).

# No results

What your customers see when a search finds nothing: relaxing, typo correction, replacement products, AI replacement and a custom page for searches without results.

Every search without a result is a lost chance. InsightSearch therefore does not give up at once but tries several ways in turn to still show something suitable. This page explains the stages in their order, the settings for them and how you improve the outcome over time.

You find the settings in the plugin configuration on the card "No results & related results". They apply in the search window and on the Shopware search results page when it is supplied by InsightSearch (see [Search results page](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-results-page.md)).

## The stages at a glance

The stages run in order until one delivers results. They only apply if the search was not already ended by a redirect from the search term rules.

1. **Relax.** The search runs again with more tolerance for typos and with partial words.
2. **Typo correction.** The system searches for the term the customer probably meant.
3. **Replacement products.** The message "No results found" stays, and below it appear products that invite browsing. With Cross-Selling Pro they come from the recommendation AI and match the search term.

All stages run within a time budget. If it is exceeded, the result stays empty.

Independently of this there are **related results**. They are not a stage but an additional list for normal results.

## Stage 1: Relax

Setting: "Relax the search when nothing is found" (default: on).

If the normal search finds nothing, the system searches again, with more typo tolerance and partial words. If that delivers results, this hint appears above them:

> No exact matches for “term”. Similar results:

This way the customer knows that the results are not exact. When loading more with "Load more results", the relaxed search continues.

## Stage 2: Typo correction

Setting: "Correct typos automatically" (default: on).

The system searches the "did you mean" term directly. Above the results it says:

> Showing results for “corrected term”.

Next to it is the link "Search for “entered term” instead". A click on it searches exactly what the customer typed, without correction. The shop remembers that for this term, also while paging and filtering. If the search was already relaxed in stage 1, the correction is relaxed as well.

## Stage 3: Replacement products

Settings:

| Setting                                       | Effect                                                                                        | Default |
| --------------------------------------------- | --------------------------------------------------------------------------------------------- | ------- |
| "Show popular products when nothing is found" | As the last stage, popular products of your shop appear below the message "No results found". | on      |
| "Number of popular products"                  | How many replacement products are shown. Allowed are 4 to 12.                                 | 8       |

The message reads `No results found for "term".` Below it is the product list with the heading "You may be interested in".

### AI replacement from Cross-Selling Pro

Setting: "Replacement products from Cross-Selling Pro - KI Cross Selling" (default: on, but only effective if the plugin is connected in the same shop).

The replacement products then come from the recommendation AI and match the search term instead of just being popular. The following applies:

* They only replace stage 3. If relaxing or correction already delivered results, the AI is not asked.
* The recommendation type "Search term" is included from the package "Starter" of Cross-Selling Pro. In the free package the normal replacement products of the search remain.
* If the recommendation quota is reached or the request takes too long (time limit 1.5 seconds in the window), the normal replacement products stay. The customer sees no error.
* Search engine crawlers and automated browsers do not query, so that they do not use up the quota.
* Purchases from these products are counted as a recommendation.
* Without Cross-Selling Pro nothing changes.

The replacement products use the standard card. If the cart button is active, it applies here too.

## Related results ("You might also like")

Settings:

| Setting                                        | Effect                                                                                 | Default |
| ---------------------------------------------- | -------------------------------------------------------------------------------------- | ------- |
| "Show related results ("You might also like")" | Products found only through AI similarity appear as a separate list below the results. | on      |
| "Number of related results"                    | How many related results are shown. Allowed are 4 to 12.                               | 8       |

Related results only appear if the AI search (hybrid search) is active for the index. More under [AI features](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/ai-features.md). In the search window they appear below the products, on the results page only on page 1.

## A custom page for searches without results

Instead of the default message you can show a shopping experience, for example with help text, category entry points, a bestseller slider or contact options.

Setting: "CMS page for search without results" (card "Search configuration").

{% hint style="warning" %}
The selection field exists only with the paid add-on "CMS for no results". Without the purchase, the configuration shows only a notice at this place, and the shop shows the default message.
{% endhint %}

* The page appears in the search window, not on the Shopware search results page.
* Active filters stay removable at the top; a banner from the search term rules still appears above the page if there is one.
* By default **no** replacement products appear below it. The page usually contains its own products, and recommendations would use up quota. If you want both, switch on "Replacement products in addition to the no-results CMS page" (default: off). The replacement products then follow below the page.
* Elements that need data of a product page have no page context in the search window. Cross-selling sliders set to "Automatic (product detail page)" have no current product here. Choose a fixed product or a type without product reference there.

More about the building blocks under [CMS elements and recommendations](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/cms-elements-and-recommendations.md).

## "Get advice"

If the shopping assistant (beta) is active, the entry "Get advice" appears with zero results directly below the message or next to the CMS page. It also appears for sentences of 4 words or more. More under [Shopping assistant (beta)](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/shopping-assistant.md).

## All settings at a glance

| Setting                                                          | Card                         | Default                                       |
| ---------------------------------------------------------------- | ---------------------------- | --------------------------------------------- |
| "Relax the search when nothing is found"                         | No results & related results | on                                            |
| "Correct typos automatically"                                    | No results & related results | on                                            |
| "Show popular products when nothing is found"                    | No results & related results | on                                            |
| "Number of popular products" (4 to 12)                           | No results & related results | 8                                             |
| "Replacement products from Cross-Selling Pro - KI Cross Selling" | No results & related results | on (effective only with the connected plugin) |
| "Replacement products in addition to the no-results CMS page"    | No results & related results | off                                           |
| "Show related results ("You might also like")"                   | No results & related results | on                                            |
| "Number of related results" (4 to 12)                            | No results & related results | 8                                             |
| "CMS page for search without results"                            | Search configuration         | no selection (only with the add-on)           |

## Examples

* **Typo:** A customer types "sprotjacket". There is no exact hit, the correction finds "sportjacket". The customer sees "Showing results for “sportjacket”" and can return to their input with one click.
* **Really nothing there:** A customer looks for a product you do not sell. They see the message and replacement products below it. With Cross-Selling Pro from the package "Starter" they match the search term.

## Tips for maintenance

* **Create synonyms.** If customers mean the same thing with different words, such as "sneaker" and "trainer", enter an equivalence under [Synonyms](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/synonyms.md). This is more effective than any rescue stage.
* **Review "Lost opportunities".** In the [Statistics](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/statistics.md) you see which terms ended without results and which rescue stage applied. Frequent terms without results are candidates for synonyms, product data or a search term rule.
* **Check product data.** If the search does not find a product, the term is often missing in the data. Check the data quality under [Products in the dashboard](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/products-in-the-dashboard.md).
* **Maintain your own page.** With the CMS page without results you guide visitors on instead of losing them. Keep it short and without duplicate product blocks.

## Read on

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

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

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

{% content-ref url="/pages/havqDZuU5OPHzDKtZ6SQ" %}
[Shopping Experiences and recommendations](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/cms-elements-and-recommendations.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/no-results.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.
