This table defines all attributes that can be passed in the product feed.
Field | Description | Notes | Required for Recommendations | Required for AttributeAI |
|---|---|---|---|---|
| Unique identifier for the product at the color level. | Must not be reused. Must match identifiers used in web tracking and transaction data. | Y | Y |
| Unique identifier for the product at the color and size level. | Must not be reused. Must match identifiers used in web tracking and transaction data. | Y | N |
| Consumer-friendly product name. | Do not include markup or formatting. | Y | N |
| Short description of the product and its attributes. | Do not include markup or formatting. | Y | N |
| Brand name of the item. | Required except for single-brand retailers. | Y | N |
| Size of the variant (e.g., UK 12). | Locale can be omitted if all sizes use the same locale. | Y | N |
| Indicates whether the specific variant is currently available. | Numeric quantity or: in stock, low stock, out of stock. | Y | N |
| Identifier grouping products that are part of a set. | Example: bikini top and bottom. | N | N |
| Identifier grouping color or pattern variants of the same product. | Strongly recommended. | N | N |
| Color name of the item. | — | N | N |
| Current selling price of the item. | This is the sale price. | Y | N |
| Original list or catalog price (RRP). | Price before discounts or sales. | Y | N |
| Indicates whether the item is discounted. | Boolean (true/false). | Y | N |
| Currency used for prices. | 3-letter ISO code (e.g., GBP, USD). Required for multi-locale feeds. | N | N |
| URL of the product detail page. | Must be a direct link (not via a tracking service). Tracking parameters may be appended if required. | Y | N |
| Product-only image, front view. | Minimum size: 200×300. | See image requirements | See image rules |
| Product-only image, back view. | Minimum size: 200×300. | See image requirements | See image requirements |
| Product-only image, side view. | Minimum size: 200×300. | See image requirements | See image requirements |
| Product image on a model, front view. | Minimum size: 200×300. | See image requirements | See image requirements |
| Product image on a model, back view. | Minimum size: 200×300. | See image requirements | See image requirements |
| Product image on a model, side view. | Minimum size: 200×300. | See image requirements | See image requirements |
| Close-up image of the product on a model, front view. | Cropped to show only the main product area. Minimum size: 200×300. | See image requirements | See image requirements |
| Close-up image of the product on a model, back view. | Cropped to show only the main product area. Minimum size: 200×300. | See image requirements | See image requirements |
| Close-up image representing the overall color or pattern. | Not a solid color block. Minimum size: 200×300. | N | N |
| Short category description. | Example: Women Dresses. | Y | Y |
| Alternative category names or IDs. | Enables category-based filtering and personalization. | N | N |
| Global Trade Item Number or EAN. | Must match barcode data. | Y | N |
| Intended gender for the item. | Required if multiple genders are present in the catalog. | Y | Y |
| Material composition of the item. | — | Y | Y |
| Additional structured attributes. | Example: fit, length. | N | N |
| Rating information for the item. | Includes average score and score distribution. | N | N |
| Indicates whether the item is sold as a bundle. | Example: matching top and bottom. | N | N |
| Indicates whether the item is a multipack. | Example: three-pack of socks. | M | N |
Image Requirements
Clothing items:
ProductOnlyFrontImageUrl,ModelFrontImageUrl,ModelBackImageUrl,ModelFrontCloseupImageUrl,ModelBackCloseupImageUrl,ModelSideImageUrlAccessories/footwear:
ProductOnlyFrontImageUrl,ProductOnlyBackImageUrl,ProductOnlySideImageUrl,ModelFrontImageUrl
If a required image type is not available, please contact support to discuss alternative options.