Variant Dict [variant_dict] Field for Product Feeds

Optional for ChatGPT

The variant_dict attribute allows you to describe variant-specific characteristics of a product using a structured object.

It enables ChatGPT to:

• distinguish variants within the same product group,
• understand differences such as color, size, material, or style,
• surface the most relevant variant based on user intent.

This field complements [group_id] and [listing_has_variations].

When to use

Use variant_dict when:

• your product has multiple variants (color, size, format, etc.),
• variants share the same product page or group,
• you want ChatGPT to reason accurately about variant-level attributes.

If your products do not have variants, this field can be omitted.

Format

• Type: Object (JSON)
• Value type: String values only
• Repeated field: No
• Schema.org property: Not applicable (AI-only field)

The object must contain:

• keys representing variant dimensions,
• values representing the specific option for the product.

Examples:

Minimum requirements

• Use valid JSON syntax.
• Keys and values must be strings.
• Keep attribute names consistent across variants.
• Do not include numeric, boolean, or nested objects.
• Do not duplicate information already provided in [title].

SEO / AI Tip

variant_dict improves ChatGPT’s ability to:

• answer variant-specific questions,
• match precise user intent (e.g. “blue running shoes size 10”),
• avoid showing incorrect variants in recommendations.

For best results, always combine:

• [group_id] for grouping variants,
• [listing_has_variations] = true,
• consistent variant naming across your feed.

Official Source: ChatGPT Product Feed Specs