Optional but Recommended for Enhanced Variant Organization in ChatGPT
The custom_variant1, custom_variant2, and custom_variant3 fields allow merchants to define up to three custom variant dimensions and their corresponding options.
These fields provide flexibility beyond standard attributes like size, color, or material, enabling richer product variant structures and filtering in ChatGPT.
When to use
Use these fields to represent customizable product dimensions that are not covered by standard attributes.
They help ChatGPT display organized variant groups and enable users to explore personalized options (e.g., frame material, fit type, edition, etc.).
Each custom variant follows a two-field structure:
| Pair | Purpose | Example |
|---|---|---|
custom_variant1_category | Defines the dimension name | Size_Type |
custom_variant1_option | Defines the selected value | Petite |
custom_variant2_category | Defines another dimension name | Wood_Type |
custom_variant2_option | Defines the associated value | Mahogany |
custom_variant3_category | Defines a third dimension name | Cap_Type |
custom_variant3_option | Defines the chosen value | Snapback |
Format
- Type: String (UTF-8 text)
- Repeated field: No
- Maximum custom variants: 3 (pairs of category + option)
- Schema.org property:
Product.additionalProperty(conceptually similar)
Examples:
| Format | Example |
|---|---|
| Text feed | custom_variant1_category: Size_Type / custom_variant1_option: Petite |
| XML feed | <custom_variant1_category>Size_Type</custom_variant1_category><custom_variant1_option>Petite</custom_variant1_option> |
| Text feed (multiple) | custom_variant2_category: Wood_Type, custom_variant2_option: Oak |
Best practices
Note: Custom variant fields improve flexibility and user experience when standard variant attributes are not sufficient.
- Use clear, descriptive names for variant categories (e.g., “Fit_Type”, “Edition”, “Finish”).
- Ensure the same category is used consistently across all products in the same group.
- Use human-readable text values for variant options.
- Don’t use generic names like “Variant_1” or “Type_A”.
- Don’t mix different categories within the same product record.
SEO / AI Tip
Custom variant fields allow ChatGPT to present structured, user-friendly variant information for complex products.
They enhance search visibility and improve conversion rates by letting customers explore product differences intuitively (e.g., finishes, fits, or editions).
Official Source: ChatGPT Product Feed Specs
Need more help?
Our team is here to assist. Reach out and we’ll get back to you fast.
Contact Support