Skip to content

Feeds

This document outlines the fields required for your product and returns feeds. If you are reading this, it is likely because we have requested a feed of your products and returns, or you want to learn more about the fields we collect from your content management system (CMS).

Products

To import your products, we need the following information:

FieldDescription
product_idA unique identifier for the product. This should match the value used in both the feeds and the widget.
product_nameThe name of the product as it appears on your product detail page.
product_brandThe brand associated with the product. (Example: “BrandName”)
product_genderThe intended gender for the product: man, woman, or unisex. (Example: “woman”)
product_sizesThe sizes available for the product. (Example: “S,M,L,XL”)
product_page_urlThe URL that leads to the product detail page on your website.
product_image_urlThe URL for a product’s image.
product_categoryThe category of the product. It can be composed of multiple layers. (Example: “Top > T-shirts”)
product_body_partThe region of the human body that the product is designed to fit or cover. Acceptable values are: bosom, top, bottom, feet, or full.

Returns

To process returned products, we need the following information:

FieldDescription
order_idA unique identifier for the order in which the product was purchased.
order_dateThe date when the product was purchased (ISO 8601). (Example: “2021-07-20”)
return_dateThe date when the product was returned (ISO 8601). (Example: “2021-07-25”)
return_reasonThe reason for the product’s return. (Example: “Too small”)
product_idA unique identifier for the product. This should match the value used in both the feeds and the widget.
product_nameThe name of the product as it appears on your product detail page.
product_sizeThe size of the returned product. (Example: “M”)
product_quantityThe number of units of the product being returned. (Example: 2)
product_priceThe price paid by the customer for the product. (Example: 29.99)
product_currencyThe currency code of price (ISO 4217). (Example: “EUR”)

Guides