> 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/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/setup-wizard-product-feed.md).

# Setup wizard: product feed

In the second part of the setup wizard you bring your product data to InsightSearch via feed or push.

For InsightSearch to recommend matching products, it needs your product data. Without this data, the recommendations have no products to choose from. In the second part of the setup wizard you decide how the products reach InsightSearch and wait until they have been read in.

This page covers steps 4 "Connect products" and 5 "Index products". Steps 1 to 3 are described in [Setup wizard: connection](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/setup-wizard-connection.md).

## Pull or push?

| Indexing mode                                            | How it works                                                                                                                 | Intended for                                                    |
| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| "Pull (default): InsightSearch fetches the product feed" | Shopware provides a product export through a sales channel of type "Product comparison". InsightSearch fetches it regularly. | Live shops. This is the normal case.                            |
| "Push: the plugin sends the products (for DEV/stage)"    | The plugin sends the products to InsightSearch itself, in batches. Shopware handles this in the background.                  | DEV and stage environments that cannot be reached from outside. |

{% hint style="warning" %}
With pull, the feed address must be reachable from outside without a login (no password protection, no htaccess restriction). With push, Shopware's background processing must run continuously, otherwise the transfer stops.
{% endhint %}

## Step 4: "Connect products"

Fill in the form. The fields appear in this order:

| Field                                                      | Required | Meaning                                                                                                                                                                   |
| ---------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Indexing mode"                                            | yes      | Pull (default) or push, see above.                                                                                                                                        |
| "Use existing product comparison sales channel (optional)" | no       | Pull only. Uses the feed template and access key of an existing product comparison channel. The other fields are then not needed. The channel must have a product export. |
| "Name"                                                     | yes      | Name for the feed and the sales channel. Prefilled with "InsightSearch Recommendations Feed".                                                                             |
| "Storefront sales channel"                                 | yes      | The channel your customers see. Only products from this channel are passed to InsightSearch.                                                                              |
| "Storefront domain"                                        | yes      | The domain through which the export can be reached, usually the main domain of the channel. Available once a channel is selected.                                         |
| "Language"                                                 | yes      | Language of the texts in the feed (titles, descriptions). Only languages of the selected channel.                                                                         |
| "Currency"                                                 | yes      | Currency of the prices in the feed. Only currencies of the selected channel.                                                                                              |
| "Customer group"                                           | yes      | The price and visibility rules of this customer group apply to the feed.                                                                                                  |
| "Use existing dynamic product group (optional)"            | no       | Empty means "Create new product group automatically". With your own group you control which products can be recommended at all.                                           |

Click **"Create feed"**.

### What is created in Shopware (pull)

* a **sales channel of type "Product comparison"** with name, language, currency and customer group from the form. It takes payment method, shipping method, country and categories from the selected storefront channel. If, for example, a payment or shipping method is missing there, creation stops.
* a **dynamic product group** with all active products, if you did not choose your own.
* a **product export** in XML format, variants included. Shopware generates it via a scheduled task.

{% hint style="info" %}
Because the export is generated by a scheduled task, Shopware's scheduled tasks must be running. Otherwise the feed file is never updated.
{% endhint %}

## Step 5: "Index products"

InsightSearch now checks the feed, evaluates the data quality and reads in the products. Three checkpoints show the progress, each with "Pending" or "Done":

| Checkpoint        | Meaning                                                |
| ----------------- | ------------------------------------------------------ |
| "Feed validation" | The feed can be reached and the required data arrives. |
| "Quality control" | The product data has been evaluated and checked.       |
| "Indexed"         | The products are ready for recommendations.            |

The display "Auto-updates every few seconds" refreshes the status regularly. Below it you see how long the process has been running. Depending on the number of products this takes a while. You can leave the page and come back later; processing continues in the background.

With push, you also see a progress bar "Products transferred" with the number of transferred products and the estimated remaining time.

### Notes during indexing

* **Push without progress for over 5 minutes:** stuck batches are queued again automatically, which can take up to 15 minutes. If nothing changes after that, check the background processing or contact support.
* **Feed takes unusually long:** this is normal for very large catalogues.
* **Status cannot be retrieved:** indexing may still be running. Reload the page later.

At the end, "All set! You can now use the recommendations." appears and you get to the plugin dashboard.

## If indexing fails

The wizard shows "Indexing failed" with the button "Try again". For feed problems, an additional help box appears with the sections "What happened?", "Possible causes" and "What you can do". It shows the "Feed address", the shop's response and the button "Open feed in browser".

For temporary errors, the wizard retries up to three times on its own, after 30, 60 and 120 seconds. "Try again now" starts immediately, "Stop automatic retries" stops the retries.

| Cause                                           | What you can do                                                                                                                                                              |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| The shop requires a login or blocks the request | Make the feed available without a login. Set up an exception for the feed address or for the user agent "CogiInsightSearch-Feed/1.0", with your hosting provider if needed.  |
| There is no feed at the feed address            | Under Sales Channels, check whether the product comparison channel still exists and is active. Compare the address with the product export; otherwise create the feed again. |
| Timeout                                         | Enable generation by cronjob in the product comparison channel and try again later.                                                                                          |
| Domain cannot be found                          | Check the channel's domain. If the system is only reachable internally, use push.                                                                                            |
| SSL certificate invalid or expired              | Renew the certificate.                                                                                                                                                       |
| No valid feed or feed without products          | Check the feed template and the channel's product assignment (visibility, product group).                                                                                    |
| Maintenance, server error, too many requests    | Try again later.                                                                                                                                                             |

{% hint style="info" %}
Stage and test systems are often protected by a password or IP restriction. Allow access to the feed there or choose push. If you are stuck, send support the feed address and the message.
{% endhint %}

If your account has several feeds and it is not clear which one is affected, the wizard does not restart anything automatically. Restart the feed in the plugin dashboard under "Available data sources".

## After the setup

You manage your data sources later in the plugin dashboard under **Products & data → Sources**:

* **"Add product feed"** creates another feed, for example for another sales channel or language. The form is the same as in the wizard.
* **"Reindex"** starts a full re-indexing. With pull, Shopware first regenerates the export; reading in then starts automatically.
* **"Automatic indexing (time)"** sets when the feed is fetched each day. The fetch starts within 15 minutes of the configured time.

Which data source applies to which sales channel and language is set under **System → Settings**. See [The plugin dashboard](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/plugin-dashboard.md) for details.

## Read more

{% content-ref url="/pages/tpVdhSmVvQ8sxMbwzbJe" %}
[Configuration assistant](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/configuration-assistant.md)
{% endcontent-ref %}

{% content-ref url="/pages/BzGfjVoUyUDgxHj1GUsV" %}
[The plugin dashboard](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/plugin-dashboard.md)
{% endcontent-ref %}

{% content-ref url="/pages/2ZVSAniefBU0WuizMlL8" %}
[Technical operation](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/technical-operation.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/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/setup-wizard-product-feed.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.
