> 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/products-in-the-dashboard.md).

# Products in the dashboard

The Products area in the plugin dashboard with overview, product list, data quality, search sandbox, rules, ranking and offline evaluation.

In the **Products** area you see what is in your search index, how good your product data is, and how you test and change the order of results. You open it via the sidebar of the plugin dashboard, in the group "Products & data". The page is called "Product management" there and carries the note "This view is in the beta phase."

The area has five tabs: "Overview", "Products", "Data quality", "Search sandbox" and "Rules".

{% hint style="info" %}
If the installation has no search index yet, it says "No search index available". First read in your product data, see [Sources](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/indices.md). If you have several data sources, choose the search index at the top. Next to it, the button "Refresh" reloads the data.
{% endhint %}

## Tab "Overview"

The tab gives a quick overview. Under "What does this tab show?" there is a short explanation. The tiles show:

* "Products in index": number of products in the search index.
* "Active attributes": active and total data attributes.
* "Synonyms" and "Filters": number of your entries.
* "Open problems": turns red when there are any.

The card "Index status" shows the "Indexing mode" (FEED or PUSH), whether the "Hybrid search" is active, the "Last sync" with date and time (or "never") and, in case of errors, the "Last indexing error". For details, contact support.

## Tab "Products"

Every product of your search index is listed here. To find and check a product:

1. Enter a search text in the field "Product ID or title...".
2. Choose the sorting: "Recently updated" (default), "Title A-Z", "ID A-Z", "Price ascending" or "Price descending".
3. Click "Apply".

The list shows 25 products per page. At the bottom you page with "← Back" and "Next →", the footer shows the page and product count. Each row has image, title, ID, price and a "Details" button. Several details can be open at once.

The detail shows a table "Attribute / Weight / Value". The weight is the search weighting of the field, a dash means there is none. This shows you which data the product actually brings to the search.

### Test findability

In a product's detail you check whether customers find it with certain terms. The plugin suggests terms taken from the words of the title (3 characters or more) and from brand, article number and GTIN, at most 8, removable with a click. You enter your own terms in the field "Add your own search term" and confirm with "+", at most 10 terms in total. After "Test findability" you see the position "of n hits" for each term.

If the search is currently not reachable, a note says the product list cannot be loaded.

## Tab "Data quality"

The tab automatically checks your product data for missing or conspicuous entries. Each row shows a traffic-light dot, the check and the count, with "(approx.)" for estimated values. A click on a row with hits shows example products with image, title and ID. If everything is fine, it says "No data quality problems found."

| Check                                          | Severity                           |
| ---------------------------------------------- | ---------------------------------- |
| "Title missing"                                | Error                              |
| "Product link missing"                         | Error                              |
| "Price is negative"                            | Error                              |
| "Image missing"                                | Warning                            |
| "Price missing"                                | Warning                            |
| "Price is 0"                                   | Warning                            |
| "No category assigned"                         | Warning                            |
| "Variant without group ID"                     | Warning                            |
| "Active attribute without values in the index" | Warning, shows the affected fields |
| "Core field with weight 0"                     | Warning, shows the affected fields |
| "Brand missing"                                | Info                               |
| "Duplicate titles (approx.)"                   | Info                               |
| "Indexed before the last sync"                 | Info                               |

Fix the errors first and the warnings afterwards. "Variant without group ID" matters if you combine variants into one hit: without the group identifier, the system searches without combining, so that not all products without an identifier collapse into a single hit.

## Tab "Search sandbox"

The sandbox is your test field. You try out search queries with changed settings without changing the live search. You can compare two settings (A/B) and get an explanation of why a product was found.

Note in the tab: you change the search mode live in the plugin configuration (per sales channel), and the field weights under "Data attributes".

### Test form

| Field                       | Meaning                                                         |
| --------------------------- | --------------------------------------------------------------- |
| "Search term"               | For example "blue shoes".                                       |
| "Language"                  | Language of the search.                                         |
| "Sorting"                   | "Relevance", "Price ascending", "Price descending" or "Newest". |
| "Hits/page"                 | At most 24, at most 5 pages.                                    |
| "Single" / "A/B comparison" | Test one setting or two against each other.                     |

For each setting (A is the base, B holds your changes) you choose the "Search mode" (Standard, Precise or Exploratory) and "Custom field weights", for example `title^8, brand^1`. If the field stays empty, the live weights apply. The checkbox "Explain score ("Why found?")" is on by default.

The strategies are explained on the page [Search in the shop](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-in-the-shop.md).

### Reading the result

The hit list shows rank, image, title and score. "Why found? (n clauses)" lists which search word matched in which field with which weight. In the comparison you see notes on rank changes or "No rank changes in the displayed hits."

### Ranking (live)

The card "Ranking (live)" differs from the rest of the sandbox: it affects the real search. Here you weight the order by business goals. This only applies when sorting by relevance.

| Setting    | Options                           | Effect                                                                                                            |
| ---------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| "Margin"   | Off, Low, Medium, High            | Products with a higher margin class rise. The plugin transmits only the class (1 to 5), never the purchase price. |
| "Novelty"  | Off, Low, Medium, High            | Young products rise. After the chosen period the bonus is halved.                                                 |
| "New for"  | 30, 60 or 90 days                 | Until when a product counts as new.                                                                               |
| "Sold out" | Off, Slightly back, Strongly back | Sold-out products move back but remain findable.                                                                  |

The default is "Off" everywhere. With "Save" you apply the values. Afterwards it says "Saved. Takes effect within one minute at the latest." Under each field it says "Data: x of y products", i.e. how many products carry the required value. Without data the factor has no effect.

The prerequisite is that in the plugin configuration, in the card "Data sharing", the switch "Transmit sales and margin class" is on (default on) and the data is current.

Pinned products and rules take precedence over these factors. Test changes beforehand in the A/B comparison under configuration B.

### Evaluate a variant offline

The card "Evaluate variant offline" answers the question: would another setting have been better? It replays the most clicked search terms of the last 30 days against a variant B and measures at which position the products that were actually clicked end up. The live search stays untouched.

You can set "Search mode live (A)", "Search mode B", "Hybrid weight" (0.1 to 0.6 in steps of 0.05), "Margin", "Novelty", "New for", "Sold out" and the checkbox "Rules off". "Start evaluation" begins the run.

{% hint style="info" %}
The clicks come from today's order, so the live state (A) has a slight advantage. If B wins anyway, that is a strong signal. An evaluation can be started at most 5 times per minute.
{% endhint %}

## Tab "Rules"

Here you maintain the search term rules with "Lost opportunities", rule list and editor. They are described in detail on the page [Search term rules](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-term-rules.md).

## Read more

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

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

{% content-ref url="/pages/0hGQB6UOZSi6fc9UUDYL" %}
[Data attributes](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/data-attributes.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 %}


---

# 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/products-in-the-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.
