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:
Field | Description |
---|---|
product_id | A unique identifier for the product. This should match the value used in both the feeds and the widget. |
product_name | The name of the product as it appears on your product detail page. |
product_brand | The brand associated with the product. (Example: “BrandName”) |
product_gender | The intended gender for the product: man, woman, or unisex. (Example: “woman”) |
product_sizes | The sizes available for the product. (Example: “S,M,L,XL”) |
product_page_url | The URL that leads to the product detail page on your website. |
product_image_url | The URL for a product’s image. |
product_category | The category of the product. It can be composed of multiple layers. (Example: “Top > T-shirts”) |
product_body_part | The 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:
Field | Description |
---|---|
order_id | A unique identifier for the order in which the product was purchased. |
order_date | The date when the product was purchased (ISO 8601). (Example: “2021-07-20”) |
return_date | The date when the product was returned (ISO 8601). (Example: “2021-07-25”) |
return_reason | The reason for the product’s return. (Example: “Too small”) |
product_id | A unique identifier for the product. This should match the value used in both the feeds and the widget. |
product_name | The name of the product as it appears on your product detail page. |
product_size | The size of the returned product. (Example: “M”) |
product_quantity | The number of units of the product being returned. (Example: 2) |
product_price | The price paid by the customer for the product. (Example: 29.99) |
product_currency | The currency code of price (ISO 4217). (Example: “EUR”) |