| File Prefix | PRODUCT |
| Current Version | V2 |
Product data represent the top level information associated with an item. It captures its basic information, category taxonomy and brand association. For every product, there needs to be one production definition.
| Attribute | Format | Length | Required | Description | Example |
| product_ref | Alphanumeric | 1-255 | Yes | Unique product reference descriptor | 103495 |
| name | Alphanumeric | 1-255 | Yes | Product title | Cristo Jacket |
| description | Alphanumeric | 1-65535 | No | Detailed description | The latest jacket in the summer collection |
| categories | Alphanumeric
; separated list
>> separated nested elements | 1-65535 | No | Product category hierarchy | Apparel>>Coats; Outdoor |
| language_code | ISO 639-1 Must belong to our supported languages | 1-65535 | No | Language used in name, description and categories | en |
| brand | Alphanumeric | 1-30 | No | Brand of the product | Adidas |
| published | Boolean [TRUE|FALSE] | | Yes | Determine if the product should be shown or searchable in the collection view. (If not published it will be hidden but can still be attached to a product variant, a product price, a product inventory, a product image or a sale) | TRUE |
product_ref is unique and case insensitive (e.g. B234c9 is considered the same as b234C9)
Categorization
Categories can be defined to facilitate filtering in the collection view. A product can be assigned to multiple categories. Products are automatically added to the All category. Other categories can be assigned via a ; separated list. Nested categories are represented by >>.
Example
A diamond ring could be assigned to the following categories.
Jewelry; Jewelry >> Rings; Jewelry >> Gemstones >> Diamond
Categories are traits of a given product. They don’t change even if the product has many variants.
Categories filters in Collection view
Localization
To localize name, description and categories, multiple rows can be sent for a given product_ref combination with a different language_code.
Example
product_ref,name,description,categories,language_code,published
103495,Cristo Jacket,The latest jacket in the summer collection,Apparel>>Coats; Outdoor,en,TRUE
103495,Veste Cristo,La dernière veste de la collection été,Vêtements>>Vestes; Extérieur,fr,TRUE
Important: When importing localized data for a product, you must include all supported languages for that product within the same file—i.e., one row per language under the same product_ref. Do not import the same product_ref in separate files with different languages. If you do, only the most recent file will be applied and earlier language‐versions may be overwritten or ignored.
