Listing Has Variations [listing_has_variations] Field for Product Feeds

Required for ChatGPT

The listing_has_variations attribute indicates whether a product listing includes multiple variants (for example: different sizes, colors, or configurations).

This field is mandatory because ChatGPT uses it to understand how products should be grouped, displayed, and validated.
When set to true, additional variant-related fields such as group_id become required.

This field does not affect how products are displayed on your website.
It strictly controls how variants are interpreted inside ChatGPT.

When to use

Use this field for every product, even if the product has no variants.

• [listing_has_variations] accepts:
  • true → The listing contains multiple variants
  • false → The listing has no variants (single product)

Examples of variants include:

• Size (S, M, L)
• Color (Black, Blue, Red)
• Material or configuration options

Format

• Type: Lower-case string (boolean)
• Accepted values: true, false
• Repeated field: No
• Schema.org property: Not applicable (AI-only field)

Examples:

Minimum requirements

• This field must be present for all products.
• Use true if the product has multiple variants.
• Use false for single-SKU products.
• Do not omit this field.
• Do not set false if variant products exist.

Important dependency:
If listing_has_variations = true, the group_id field becomes mandatory.

SEO / AI Tip

Explicitly declaring whether a product has variants helps AI systems:

• group related SKUs correctly,
• avoid duplicate or fragmented listings,
• present clearer options to users in conversational commerce.

Incorrect or missing variation logic can cause:

• products to be ignored,
• variants to be misinterpreted as separate items,
• validation failures during feed ingestion.

For best results, combine this field with:

• [group_id]
• [variant_dict]
• Variant attributes such as [color], [size], [material]

Official Source: ChatGPT Product Feed Specs