> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cevoid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Product feeds

> Sync your product catalog to Cevoid using product feeds.

<Note>
  Related articles: [Products & Markets](/general/products-markets), [UGC introduction](/ugc/introduction), [Galleries](/ugc/showcase/galleries)
</Note>

Product feeds sync your product catalog with Cevoid, enabling product tags on posts and product-based galleries. Use product feeds when you're not using Shopify or WooCommerce, or when you need custom catalog data.

Navigate to [Settings -> Products & Markets](https://app.cevoid.com/settings/products-and-markets) to configure your feeds.

***

## Add a product feed

1. Navigate to [Settings -> Products & Markets](https://app.cevoid.com/settings/products-and-markets)
2. Edit an existing market or create a new one
3. Scroll to the Product feed section
4. Click **Add product feed**
5. Enter the URL to your product feed
6. Select the file format (XML, CSV, or TSV)
7. If password-protected, click **Authentication** and enter credentials
8. Click **Connect feed**
9. Map each field to the corresponding value in your feed
10. Click **Create feed**

***

## Field mapping

Once connected, a preview of your feed displays. Map your feed fields to Cevoid's values.

| Field                   | Required | Description                                                                                                   | Used for                                                      |                                                         |
| ----------------------- | -------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------- |
| *ID*                    | ✓        | Unique identifier for each product variant                                                                    | Connects products across markets so you only tag once         |                                                         |
| *Product title*         | ✓        | The product name                                                                                              | Displayed in product tags                                     |                                                         |
| *Link*                  | ✓        | URL to the product page                                                                                       | Where visitors go when clicking a product tag                 |                                                         |
| *Product price*         | ✓        | Price. With or without currency symbol; symbol is removed at import.                                          | Displayed in product tags                                     |                                                         |
| *Image link*            | ✓        | Primary product image                                                                                         | Displayed in product tags                                     |                                                         |
| *Item group ID*         |          | Groups product variants together                                                                              | Product tagging and product page gallery fallback             |                                                         |
| *Additional image link* |          | Secondary product image                                                                                       | Shown on hover over product tag                               |                                                         |
| *Sale price*            |          | Discounted price if on sale                                                                                   | Displayed alongside regular price                             |                                                         |
| *Availability*          |          | Stock status                                                                                                  | Hide out-of-stock products                                    |                                                         |
| *Category*              |          | Hierarchical categories<br />Supported seperators:  \`, /                                                     | > \< →\`                                                      | Tagging filter, Library filter, category page galleries |
| *Collection(s)*         |          | The collections the product belongs to.<br />Can be send as one tag, or seperate once for grouped collections | Tagging filter, Library filter, collection page galleries     |                                                         |
| *Variant options*       |          | Options like color and size<br />One tag per variant option.                                                  | Variant selection when tagging, product page gallery fallback |                                                         |

<Tip>
  Item group ID is strongly recommended. It groups product variants together for better tagging and fallback behavior. If you don't provide Item group ID, Cevoid analyzes URL paths to create groupings automatically
</Tip>

## Product feed example

```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    {/*  Required fields  */}
    <id>1001-BLK-M</id>
    <product_title>Classic Cotton T-Shirt</product_title>
    <link>https://cevoid.com/product/classic-cotton-t-shirt</link>
    <product_price>29.99</product_price>
    <image_link>https://cdncevoid.com/image/classic-tee-black-front.jpg</image_link>

    {/*  Optional fields  */}
    <item_group_id>1001</item_group_id>
    <additional_image_link>https://cdncevoid.com/image/classic-tee-black-lifestyle.jpg</additional_image_link>
    <sale_price>19.99</sale_price>
    <availability>in_stock</availability>
    <category>Apparel &gt; Tops &gt; T-Shirts</category>

    {/*  Collections (Optional)  */}
    <gender>Women, Unisex</gender>
    <styles>Casual, Streetwear, Minimalist, Everyday</styles>

    {/*  Variant options (Optional)  */}
    <size>M</size>
    <color>Black</color>
  </product>
</products>
```

***

## FAQ

**What format should feeds be in?**

Google Shopping feed schema is most common, but we support custom field names that you map during setup.

**What file formats are supported?**

XML, CSV, or TSV.

**Can we have multiple feeds per market?**

Yes. Add multiple feeds if your catalog is split across files. Usually one is enough.

**What if we modify our feeds?**

All fields except product ID can be remapped freely. Changes apply after the next product sync.

<Warning>
  Product tags are connected to the product ID. Contact Cevoid support before remapping the ID field.
</Warning>