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. (Example: “1000332511”)
product_nameThe name of the product as it appears on your product detail page (PDP). (Example: “Blue Shirt”)
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
product_idA unique identifier for the product as it appears in your dashboard. (Example: “1000332511”)
order_idA unique identifier for the order in which the product was purchased. (Example: “142235”)
product_nameThe name of the product. (Example: “Blue Shirt”)
order_dateThe date when the product was purchased. (Example: “2021-07-20”)
return_dateThe date when the product was returned. (Example: “2021-07-25”)
return_reasonThe reason for the product’s return. (Example: “Too small”)
sizeThe size of the returned product, if applicable. (Example: “M”)
quantityThe number of units of the product being returned. (Example: 2)
priceThe price of the product. (Example: 29.99)