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

# Product feeds

A product feed is a detailed representation of a retailer's entire product catalog. It has two main uses in Engage.

The first is when Engage needs to *communicate products in emails*. This applies both to manual use cases, such as product feed modules where specific product IDs are inserted, and automated scenarios like abandoned cart, browse abandonment, and back-in-stock flows. In this context, the product feed is purely used for communication.

The second use of a product feed is to populate the article register. See more about that here:

<Card title="Learn about the article register" href="/docs/setup/article-register" icon="https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=fbd08f956358ab12f664a7158e1a1399" horizontal width="128" height="128" data-path="icons/developer-link.png" />

## Product feed structure

Product feeds must be in a standard XML format, such as the Google Merchant Center feed format (which Voyado recommends) and must be *directly accessible through an open URL*.

<Tip>
  While a product feed URL must be open, it is possible to restrict access by allow-listing only those IP adresses that Engage will use. Talk to your Voyado account manager if this is something you need.
</Tip>

The URL for a retailer's product feed (or feeds) is entered into the Engage back-end, by their Voyado team. If the feed exists in different languages, a feed can be defined for each language.

<Warning>
  Voyado recommends 800 000 items as the maximum in a product feed, to assure the best experience with Engage. If you need to have a product feed with more items, contact your Voyado account manager. Products of interest are connected to the *article register* and not the product feed.
</Warning>

<Accordion title="Example of a product feed">
  This simplified example above contains one item node. An actual product feed will usually have all of a retailer's products, which can be thousands or even millions of item nodes.

  ```xml theme={null}
  <rss xmlns:g="http://base.google.com/ns/1.0">
    <channel>
      <title>ExampleShop.dk - Example</title>
      <link>https://www.ExampleShop.dk</link>
      <description />
      <item>
        <title>Taljebælte til line Showmaster®</title>
        <link>https://www.ExampleShop.dk/hund/aktivering-traening/traening/taljebaelte-til-line</link>
        <description>Taljebælte med indbygget forlængelse, som dæmper ryk fra din hund. Benstropper forhindrer, at bæltet kryber op over hofterne. Justerbart mellem 75 - 130 cm.</description>
        <g:id>041213-10-00000</g:id>
        <g:product_type>Hund > Aktivering & Træning</g:product_type>
        <g:brand>Showmaster®</g:brand>
        <g:image_link>https://www.ExampleShop.dk/pub_images/large/041213-10-00000_1.jpg?timestamp=1618572964</g:image_link>
        <g:condition>new</g:condition>
        <g:availability>in stock</g:availability>
        <g:price>199.00 DKK</g:price>
        <g:gtin>7315470000683</g:gtin>
        <g:mpn />
        <g:item_group_id>20381</g:item_group_id>
        <g:google_product_category />
        <g:identifier_exists>TRUE</g:identifier_exists>
        <g:color>Sort</g:color>
        <g:shipping>
          <g:country>DK</g:country>
          <g:service>Standard</g:service>
          <g:price>0.00 DKK</g:price>
        </g:shipping>
        <g:additional_image_link>https://www.ExampleShop.dk/pub_images/large/041213-10-00000_2.jpg?timestamp=1618572965</g:additional_image_link>
        <g:custom_label_0>281</g:custom_label_0>
      </item>
    </channel>
  </rss>
  ```
</Accordion>

<Card title="Read about using product feed in email modules" href="https://help.engage.voyado.com/hc/en-gb/articles/17233923437340-Product-feed-in-email-modules" icon="https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/help-center-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=3e7ca2ce0b8cfb9fbd27a4bdf53b2ce1" horizontal width="128" height="128" data-path="icons/help-center-link.png" />

## Importing a product feed

To import a product feed into Engage, the feed needs to contain all the products that can be purchased at all of a retailer's locations (e-commerce web sites as well as physical shops) and it needs to be in a single master language.

It is recommended to let the PIM (Product Information Management) system generate the product feed XML file rather than the web shop.

<Warning>
  When migrating historical transactions, the product feed won't be able to add metadata, since the feed normally contains current data (the e-com does not need “old” data to be sent out to, for example, Google Shopping). Therefore, you might end up missing historical data. In some cases, a separate migration is recommended. Talk to your Voyado PM about the best approach.
</Warning>