We support feeds as JSON, CSV or XML. The feed should be refreshed at least every hour - otherwise it will take too much time for your product updates to take effect on your site.

📘 One feed per market

If your site has multiple markets, you need to provide a product feed for each of them. Each feed should then contain the correct URLs, translations and prices for that market.

Mandatory product attributes

These are attributes required by Depict for all products in your feed. These attributes are essential for the successful representation of your product data.

The following table shows the minimum required product attributes, their accepted data types, and descriptions:

Title
string

The product’s name.Example value: Blue Men's T-Shirt.

Product ID
string

Identify each product using the product ID attribute. This attribute must be unique across all of your products. This attribute should also be at the lowest possible level.If a T-shirt comes in sizes S,M,L, then each size should have its own product*id. Example value: stylish-shirt-blue-XS.

SKU
string

A unique identifier for all possible variants of a product. This might be shared across products.If a T-shirt comes in sizes S,M,L they could share the same SKU but have different product IDs.This ID must be the same ID used in Google Analytics for transactions of this product. Example value: stylish-shirt-blue.

Item group ID
string

A unique identifier for each group of variants. The item group ID identifies a set of products that differ by one or more variant attributes, such as color, size, etc.If a T-shirt comes in sizes S,M,L and colors Black and White, the 6 products should have the same item group ID. Example value: stylish-shirt.

Description
string

The product’s description. Describe each product clearly using the description attribute.Example value: Premium T-Shirt with loose fit for a carefree, comfortable look. Its heavyweight organic cotton fabric feels thick and soft. This product is made with at least 75% organic cotton fibers..

Price
float

The product’s standard price. This value represents the price of the product in each market.Example value: 123.50.

Sale price
float

The product’s sale price. If sale price does not apply, submit the same value as the price.Example value: 100.50.

Currency
string

This value represents the currency of your defined product prices in each market.Example value: EUR.

Main Image URL
string

The URL of the product’s main image.Example value: https://yourstore.com/img1.jpg.

Additional image URL
[string]

A list of all image URLs associated with a product.Example value: https://yourstore.com/img1.jpg, https://yourstore.com/img2.jpg, https://yourstore.com/img3.jpg.

Page URL
string

The URL of the product’s landing page.Example value: https://yourstore.com/t/mens-t-shirt-mkhTvc/ABC1234-667.

Availability
boolean

The product’s availability. If this attribute is absent, Depict may recommend an out-of-stock item to a user.Example value: true.

Category ids
[string]

Identifiers of the categories this product belongs to. Should match the ids in the category feed.

Optional product attributes

Including these product attributes is optional for all merchants and depends on your product inventory. However, adding more features enables us to give a better user experience, as well as improving the output of the underlying algorithms.

The following table shows these optional attributes, their accepted data types, and descriptions:

Quantity
int

The number of products currently kept in stock. Is used to calculate more advanced inventory analytics, such as sell-through-rate. Example value: 51.

Color
string

The product’s color. The value is required for all products with different color variants. Example value: blue.

Size
string

The product’s size. This is a required value for all products with different size variants. Example value: XL.

Gender parameters
string

This is a required value for all products with gender-specific variants. Example value: Female.

Age group
string

This is a required value for all products with assigned age groups. Example value: kids.

Brand
string

The product’s brand name. Example value: Adidas.

Series
string

The product’s series. Example value: 2021 Off-White Track collection.

Designer
string

The product’s designer. Example value: Sasha Hao.

Bundle
boolean

Indicates whether or not this product represents a collection of different products. Example value: false.

Pattern
string

The product’s pattern. The value is required for all products with different pattern variants. Example value: striped.

Add-to-cart product ID
string

Used when adding items to cart on the frontend. Example value: ABC1234.

Cost of goods sold
float

The sum of all direct cost associated with sale of a product. Example value: 234.50.

GTIN
string

Include for all products with a known GTIN. Example value: 3275637890676.

MPN
string

Include for all products without a manufacturer-assigned GTIN. Example value: ABC-1243D-EF.

Is second hand
bool

Marks this product as being second hand. Example value: true.

Custom product attributes

In addition to all the attributes listed above, you can also include completely custom attributes. This data will be stored alongside the product and can then be used to setup filters, rankings, and custom scoring.