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

# Sources

View, create, re-import and delete data sources, with status, figures and error help.

In the **Sources** area you see all data sources from which the search gets its products. Here you create new product feeds, re-import product data after changes and delete sources you no longer need.

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-d3992095aa084896b2adb5b8eb270564f4689f39%2Fsuche-intelligent-und-ki-optimiert-quellen.png?alt=media" alt="Sources area with a data source, figures and time of the automatic indexing"><figcaption></figcaption></figure>

If there is no source yet, a yellow warning says that no products have been imported for search and recommendations. In that case create a source with "Add product feed".

## The card of a data source

Every data source has a card with its name and a status.

### Status

| Status                        | Meaning                                                   |
| ----------------------------- | --------------------------------------------------------- |
| Ready (green)                 | The source is imported and up to date.                    |
| Pending / Processing (yellow) | The import is waiting or being prepared.                  |
| Sync in progress (yellow)     | The import is running right now.                          |
| Failed (red)                  | The import failed.                                        |
| Sync failed (red)             | The last synchronization failed. The source still exists. |
| Unknown status (gray)         | The state is not known.                                   |

### Figures

The card shows "Language", "Currency", "Products" (count), "Mode", "Last indexing" and "Next indexing". If a value is missing, it says "Not set". For feeds you also see the feed address.

The **mode** tells how the products reach us:

* **Feed (pull):** Our system fetches your shop's product feed regularly.
* **Push:** Your shop sends the products to our system itself. This is meant for development and staging environments that cannot be reached from outside. Shopware's background processing must be running for this.

## The buttons

| Button                 | Effect                                                                              |
| ---------------------- | ----------------------------------------------------------------------------------- |
| Refresh view           | Only reloads the display of status and figures. No products are imported.           |
| Add product feed       | Opens the "Add another feed" dialog (see below).                                    |
| Re-import product data | Imports all product data of the source again, immediately and without confirmation. |
| Edit data fields       | Opens the editor where you decide which product data is transferred.                |
| Delete                 | Removes the data source together with its search data (see below).                  |

You only see "Re-import product data" and "Delete" for the statuses "Ready", "Pending" and "Sync failed". They are missing for "Failed" and while an import is running. "Edit data fields" only appears if the source belongs to a product comparison sales channel of your shop or is a push source. For an external feed there is no such button.

{% content-ref url="/pages/gwPJIHZL0Lc3ekLkAsPI" %}
[Edit data fields](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/feed-template-editor.md)
{% endcontent-ref %}

### Manual import

With "Re-import product data" you can import again at any time. It does not work if the data source is blocked by InsightSearch or a run is already active. In case of a block, a note asks you to contact support. The message "Indexing was started." confirms the start.

After changes to data fields, data attributes or synonyms a re-import is needed for them to take effect.

### Delete

The "Delete" button asks for confirmation in the "Delete feed" dialog. When you delete a source:

* The search index of this source is deleted, including the data for search suggestions.
* The related data attributes, synonyms, filters and import logs are deleted.
* Statistics data is deliberately kept.
* With push, the push data in your shop is removed as well (jobs, sessions, field settings).

{% hint style="warning" %}
Deleting cannot be undone. Afterwards you would have to create synonyms, filters and data attribute settings again. If you uninstall the plugin, the data sources are deleted in the same way.
{% endhint %}

## Add another feed

"Add product feed" opens the "Add another feed" dialog. It is the same as in the setup wizard. The default is a product feed that Shopware generates as a sales channel of type "Product comparison" and that our system imports automatically.

| Field                                                               | Effect                                                                                                                                                                                                    | Default                                      |
| ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| Indexing type                                                       | "Pull": InsightSearch fetches the product feed. The feed address must be reachable from outside, so without password protection. "Push": the plugin sends the products, for development and staging only. | Pull                                         |
| Name                                                                | Name for the product feed and its sales channel, e.g. "Feed staging shop". Required.                                                                                                                      | "InsightSearch Feed"                         |
| Storefront sales channel                                            | Only products from this channel go to the search. Required. Only storefront channels are possible.                                                                                                        | none                                         |
| Storefront domain                                                   | Domain of the channel, usually the main domain. Selectable once a channel is chosen. Required.                                                                                                            | Preselected if there is only one domain      |
| Language                                                            | Language of the texts in the feed. Only languages of the channel. Required.                                                                                                                               | Default language of the channel              |
| Currency                                                            | Applies to all prices in the feed. Required.                                                                                                                                                              | Currency of the channel                      |
| Customer group                                                      | Price and visibility rules apply on this basis, so the feed uses the same conditions as the shop. Required.                                                                                               | Customer group of the channel                |
| Use existing dynamic product group (optional)                       | Only needed if you want to use your own group.                                                                                                                                                            | A new product group is created automatically |
| Use existing product comparison sales channel (optional), pull only | Uses the feed template and access key of an existing channel. The other fields are dropped.                                                                                                               | none                                         |

If you change the sales channel, domain, language, currency and customer group are preset again. "Create feed" is only active once all required fields are filled. There is no choice of feed template; it is created automatically. You can adjust it later through "Edit data fields".

**What is created in your shop with pull:**

1. A sales channel of type product comparison with your name.
2. A dynamic product group "InsightSearch Feed" with date and time that contains all active products (if you did not choose your own).
3. A product export as an XML file, generated by a scheduled task in Shopware.
4. The registration with InsightSearch. This automatically creates the language assignment for the channel and the chosen language.

Shopware then checks the feed template. If it is faulty, the feed is not registered and the channel that was already created stays selected. A new attempt does not create a second one.

With **push** no sales channel and no export are created. A push index is created and the transfer starts immediately. If the start fails, trigger it later with "Re-import product data".

## Automatic indexing (pull only)

In the **Automatic indexing (time)** field you set when the source is imported daily. The time zone is shown next to it. The time is saved as soon as you leave the field ("Time was saved."). Indexing starts within 15 minutes after the set time. If you leave the field empty, automatic indexing is off. The card then shows the next indexing again.

Push sources have no time field.

## Dynamic product group (push only)

For push sources you choose in the **Dynamic product group** field which products are transferred. "Edit" opens the group in Shopware. The choice is saved immediately. Without a product group, all products of the sales channel are transferred.

## Progress and errors

**Pull.** While importing, a bar shows "Synchronizing ...", and the view refreshes every 5 seconds. A feed run cannot be aborted.

**Push.** The card shows "Indexing in progress ..." with count, percent, estimated remaining time and products per second. "Abort" ends the run after a confirmation. If there is no progress for 5 minutes, a note says that stuck packages are queued again automatically. During the transfer there is always a note that Shopware's background processing must run permanently, otherwise progress stands still. If it does not run at all, indexing counts as failed after at most one hour without progress and can be restarted.

**On an error.** A red box names the cause, with the "Restart" button for push. Typical messages are "No matching products were found for indexing.", "Configuration incomplete. Please check the setup." and "Synchronization of this index is currently blocked. Please contact support." For pull feeds a help block ("Show help") explains the cause in plain words, names the feed address and says what you can do.

{% 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 %}

## AI preparation

After importing, we prepare the data for the AI features. While this runs, or if it fails, the card shows an "AI preparation" bar with a list of steps (pending, running, done). Afterwards the bar disappears. If it fails, the card says: "AI preparation failed. It will be tried again at the next sync." In the overview you see during this time how many indices are being prepared.

## Further reading

{% content-ref url="/pages/kG1p17yKCiPZb4o3gw2S" %}
[Push and live synchronisation](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/push-and-live-sync.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/aMfV4gWX34ThmeivNqiQ" %}
[General settings](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/general-settings.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/indices.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.
