Where: Product data → New dataset.
A dataset contains the products your Advice flow can recommend. You can connect the same dataset to multiple Advice flows and choose a different product selection for each flow.
Paid plans include unlimited datasets. The free plan includes one dataset. Your plan’s total product allowance still applies across your datasets.
1. Choose your source
| Source | When to use it | Updates |
|---|---|---|
| External feed | Your webshop or feed tool provides a product feed URL. | Every 6 hours by default; you can also import manually. |
| Manual upload | You have a CSV, XML or JSON file. | Upload a new file yourself when products change. |
A feed URL points to product data, not a regular category page. Ask your webshop administrator for an export containing product ID, title, product link, image, price and the properties shoppers choose by. See an example feed.
Using Magento? The product feed module can create the export.
2. Create the dataset and import
- Click New dataset and give the collection a recognizable name.
- Choose the currency used by the prices in your feed.
- Choose External feed and paste the URL, or Manual upload and select your file.
- Check the source with Check feed and finish creating the dataset.
- If needed, open Source and choose Save and import. Wait for the import to finish.
You can leave the page during import. Check progress and the outcome on the dataset page.
3. Check the mapping
Mapping means choosing which field in your file provides each piece of product information. Familiar field names are often recognized automatically; check the suggested connections.
| Mapping | Example feed field | Used for |
|---|---|---|
| Product ID | id or sku |
Required: recognizing the same product during updates. |
| Title | name or title |
Required: the product name. |
| Product link | url or link |
Required: the product detail page. |
| Image | image_url |
A recognizable product card. |
| Price | price or regular_price |
The regular price. |
| Sale price | sale_price |
The lower selling price, when available. |
Product images load directly from the image URLs in your feed. They are not copied into your media library. Large source images can slow down the display of product cards; use appropriately sized images from your webshop or image provider where available.
Click Save mapping and wait for product data to update. Map the regular price to Price and any lower promotional price to Sale price.
Properties such as material, size or use case appear under Properties & Swatches. You do not need to map them to Title or Label to use them in matching.
For matching, provide values in a usable format:
- Text: a name such as
Hiking shoe model 120remains text and supports comparisons such as Contains any. - Numbers: put a size such as
42in a separate field without units or descriptions, so you can use Greater than. - Yes/no:
true/false,1/0,yes/noandon/offare recognized as booleans.ja/neeandin_stock/out_of_stockremain text; match their original values.
4. Check and connect the products
Open Products and check several different items, including a discounted product. Under Properties & Swatches, check that the values you want to match on are present.
Then open your Advice flow → Settings → General, select the dataset and save. Continue with Matching.
You are ready when: your products display correctly and the connected Advice flow can use their properties.
Update products
Import updates into the same dataset and keep the same Product IDs. Products missing from a new complete import become inactive and no longer count toward recommendations.
A successful product import updates the catalog used by recommendations. You do not need to republish for every price change. When you change questions, matching or styling, check the draft and publish the flow again.
Group variants on one advice card
Map Advice group when colors or sizes of one product should share a recommendation card. Each variant keeps its own Product ID; all variants share one group value. Fields such as item_group_id are recognized.
The highest-scoring variant appears first. Your sorting settings decide between equal scores. Visitors can choose another variant on the card.
Need translated titles or links for another country? Read Translations and product languages. Import stuck or a field empty? See help with problems.
If a published product selection remains empty after a product update, an alert appears in the app. See checking a product filter alert for the steps to restore advice.
