Product Feed Attributes Reference

Prev Next

This table defines all attributes that can be passed in the product feed.

Field

Description

Notes

Required for Recommendations

Required for AttributeAI

Id

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

VariantId

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

Name

Consumer-friendly product name.

Do not include markup or formatting.

Y

N

Description

Short description of the product and its attributes.

Do not include markup or formatting.

Y

N

BrandName

Brand name of the item.

Required except for single-brand retailers.

Y

N

Size

Size of the variant (e.g., UK 12).

Locale can be omitted if all sizes use the same locale.

Y

N

Availability

Indicates whether the specific variant is currently available.

Numeric quantity or: in stock, low stock, out of stock.

Y

N

SetId

Identifier grouping products that are part of a set.

Example: bikini top and bottom.

N

N

GroupId

Identifier grouping color or pattern variants of the same product.

Strongly recommended.

N

N

Color

Color name of the item.

N

N

Price

Current selling price of the item.

This is the sale price.

Y

N

ListPrice

Original list or catalog price (RRP).

Price before discounts or sales.

Y

N

IsDiscounted

Indicates whether the item is discounted.

Boolean (true/false).

Y

N

Currency

Currency used for prices.

3-letter ISO code (e.g., GBP, USD). Required for multi-locale feeds.

N

N

Url

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

ProductOnlyFrontImageUrl

Product-only image, front view.

Minimum size: 200×300.

See image requirements

See image rules

ProductOnlyBackImageUrl

Product-only image, back view.

Minimum size: 200×300.

See image requirements

See image requirements

ProductOnlySideImageUrl

Product-only image, side view.

Minimum size: 200×300.

See image requirements

See image requirements

ModelFrontImageUrl

Product image on a model, front view.

Minimum size: 200×300.

See image requirements

See image requirements

ModelBackImageUrl

Product image on a model, back view.

Minimum size: 200×300.

See image requirements

See image requirements

ModelSideImageUrl

Product image on a model, side view.

Minimum size: 200×300.

See image requirements

See image requirements

ModelFrontCloseupImageUrl

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

ModelBackCloseupImageUrl

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

ColourSwatchImageUrl

Close-up image representing the overall color or pattern.

Not a solid color block. Minimum size: 200×300.

N

N

Category

Short category description.

Example: Women Dresses.

Y

Y

ExtraCategories

Alternative category names or IDs.

Enables category-based filtering and personalization.

N

N

GTIN / EAN

Global Trade Item Number or EAN.

Must match barcode data.

Y

N

Gender

Intended gender for the item.

Required if multiple genders are present in the catalog.

Y

Y

Composition

Material composition of the item.

Y

Y

Attributes

Additional structured attributes.

Example: fit, length.

N

N

Rating

Rating information for the item.

Includes average score and score distribution.

N

N

Bundle

Indicates whether the item is sold as a bundle.

Example: matching top and bottom.

N

N

Multipack

Indicates whether the item is a multipack.

Example: three-pack of socks.

M

N


Image Requirements

  • Clothing items: ProductOnlyFrontImageUrl, ModelFrontImageUrl, ModelBackImageUrl, ModelFrontCloseupImageUrl, ModelBackCloseupImageUrl, ModelSideImageUrl

  • Accessories/footwear: ProductOnlyFrontImageUrl, ProductOnlyBackImageUrl, ProductOnlySideImageUrl, ModelFrontImageUrl

If a required image type is not available, please contact support to discuss alternative options.