Feed Attributes¶
The feed must include the following attributes:
| Field | Required | Description |
|---|---|---|
| Parent Product ID | Mandatory | Unique ID for the product; all variants under it share this ID |
| Variant ID | Mandatory | Unique ID for the variant under a product |
| Style ID | Mandatory | Unique ID for all size options under a single color of a product |
| Name | Mandatory | Title of the variant displayed on the website |
| Description | Mandatory | Description of the variant (within ~30 words if possible) |
| Original Price | Mandatory | Original price of the variant |
| Selling Price | Mandatory | Current selling price of the variant |
| Discount | Mandatory | Final discount on the variant |
| Price Currency | Mandatory | Currency of the price (e.g., USD, INR) |
| Category | Mandatory | Full category path — values must match Shopify Taxonomy exactly |
| Product Type | Mandatory | Similar to Category, but defined by the brand/retailer |
| Deep Link URL | Mandatory | Opens the product detail page with the correct variant pre-selected; purchases from the session must be accurately attributed (affiliate links need tracking parameters) |
| Link URL | Mandatory | Product URL that opens the product page with the current variant selected |
| Image URL | Mandatory | Main variant image — model facing front, product clearly visible, no watermarks or promo text. JPEG/JPG/PNG/WEBP, 9:16 aspect, min 720 × 1280 px |
| Retailer Domain | Mandatory | Domain of the retailer (e.g., www.walmart.com) |
| Alternate Image URLs | Mandatory | All other images of the variant, pipe-separated |
| Is On Sale | Mandatory | true if the variant is on sale and Sale Price is present, else false |
| Is In Stock | Mandatory | true if the variant is in stock, else false |
| Inventory Quantity | Optional | Number of units available for the variant |
| Low Stock Flag | Optional | true if variant stock is low |
| Brand | Mandatory | Brand of the product (e.g., H&M, Zara) |
| Size | Mandatory | Size of the variant (S, M, L, XL…) |
| Color | Mandatory | Color of the variant |
| Gender | Mandatory | Male, Female, or Unisex |
| Age Group | Mandatory | Baby, kids, adults, etc. |
| Global Unique Identifier | Optional | Globally consistent ID to match identical products across retailers — GTIN (UPC/EAN/ISBN/GTIN-14), MPN, or another stable manufacturer-level ID. Send as a key–value pair, e.g. {"GTIN": "0123456789012"} |
| Material | Mandatory | Material of the product (fabric or other relevant details) |
| Care Instructions | Optional | Care and washing/ironing instructions |
| Detailed product attributes | Optional | Fit / Pattern / Length or other attributes, as pipe-separated key:value pairs |
| Return Policy | Mandatory | Return policy set by the retailer |
| Shipping Cost | Mandatory | Shipping cost for the variant; give a range if it depends on zip code |
| Delivery Time | Mandatory | Approximate delivery time for the product |
| Num Ratings | Optional | Number of ratings on the product/variant |
| Average Ratings | Optional | Average rating of the product/variant |
| Reviews | Optional | Review text, images, reviewer, variant reviewed |
| Number of Reviews | Optional | Number of users who have reviewed |
| Size chart | Optional | Size chart for the product, if available (image) |
| Available coupons / offers | Optional | Coupon codes, EMI offers, bank-card discounts, etc. |
| Product tags | Optional | Tags like New Arrival, Bestseller, Recycled, Organic |
| Similar products | Optional | Parent Product IDs of similar products recommended by the brand/retailer |
| Complimentary products | Optional | Parent Product IDs of "users who purchased this also liked" products |