Overview
The Product Feed Specification defines how merchants share structured product data with OpenAI so ChatGPT can accurately surface their products in search and shopping experiences.
How it works
- Prepare your feed. Format your catalog using the Product Feed Spec (see Field reference for required and optional attributes with sample values).
- Deliver the feed. Share the feed using the preferred delivery method and file format described in the integration section.
- Ingestion and indexing. OpenAI ingests the feed, validates records, and indexes product metadata for retrieval and ranking in ChatGPT.
- Keep it fresh. Update the feed whenever products, pricing, or availability change to ensure users see accurate information.
Key points
- Structured source of truth. OpenAI relies on merchant-provided feeds—this ensures accurate pricing, availability, and other key details.
- Built for discovery. The feed powers product matching, indexing, and ranking in ChatGPT.
- Integration guidance. The spec defines the preferred delivery method and file format for reliable ingestion.
- Field reference. A complete list of required and optional attributes (with examples) is provided to help you validate your feed.
- Freshness matters. Frequent updates improve match quality and reduce out-of-stock or price-mismatch scenarios.
Integration Overview
Before providing product data, merchants must sign up at chatgpt.com/merchants.
This section outlines the key logistics: how the feed is delivered, acceptable file formats, and the initial steps required to validate your data, so engineering teams can plan with confidence.
All transfers occur over encrypted HTTPS to the allow-listed endpoint to protect merchant and customer information and ensure that only approved partners can send or update product feeds.
| Topic | Details |
|---|---|
| Delivery model | Merchants push feeds to OpenAI at a mutually agreed endpoint or secure transfer location. |
| File format | Supported formats are TSV, CSV, XML, or JSON. Choose whichever fits your existing export process. |
| Refresh Frequency | Our system accepts updates every 15 minutes. |
| Initial load | Send a sample or full initial feed so our indexing team can validate parsing before live updates begin. |
Field Reference
To make your products discoverable and purchasable inside ChatGPT, merchants provide a structured product feed that OpenAI ingests and indexes. This specification defines the complete schema: field names, data types, constraints, and example values needed for accurate search, pricing, and checkout experiences.
Each table below groups attributes by category (Basic Data, Media, Pricing, etc.) and clearly indicates whether a field is Required, Recommended, or Optional, along with validation rules to help your engineering team build and maintain a compliant feed.
Supplying all required fields ensures your products can be displayed correctly, while recommended fields enrich relevance and user trust.
OpenAI Flags
Use these flags to control whether a product is discoverable and/or purchasable inside ChatGPT. These fields do not affect how the product is displayed on your own site, they simply enable or disable the ChatGPT integrations.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| enable_search | Enum | true, false | Controls whether the product can be surfaced in ChatGPT search results. | true | Required | — | Lower-case string |
| enable_checkout | Enum | true, false | Allows direct purchase inside ChatGPT. enable_search must be true in order for enable_checkout to be enabled for the product. | true | Required | — | Lower-case string |
Basic Product Data
Provide the core identifiers and descriptive text needed to uniquely reference each product. These fields establish the canonical record that ChatGPT Search uses to display and link to your product.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| id | String (alphanumeric) | — | Merchant product ID (unique) | SKU12345 | Required | — | Max 100 chars; must remain stable over time |
| gtin | String (numeric) | GTIN, UPC, ISBN | Universal product identifier | 123456789543 | Recommended | — | 8–14 digits; no dashes or spaces |
| mpn | String (alphanumeric) | — | Manufacturer part number | GPT5 | Required if gtin missing | Required if gtin is absent | Max 70 chars |
| title | String (UTF-8 text) | — | Product title | Men's Trail Running Shoes Black | Required | — | Max 150 chars; avoid all-caps |
| description | String (UTF-8 text) | — | Full product description | Waterproof trail shoe with cushioned sole… | Required | — | Max 5,000 chars; plain text only |
| link | URL | RFC 1738 | Product detail page URL | https://example.com/product/SKU12345 | Required | — | Must resolve with HTTP 200; HTTPS preferred |
Item Information
Capture the physical characteristics and classification details of the product. This data helps ensure accurate categorization, filtering, and search relevance.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| condition | Enum | new, refurbished, used | Condition of product | new | Required if product condition differs from new | — | Lower-case string |
| product_category | String | Category taxonomy | Category path | Apparel & Accessories > Shoes | Required | — | Use “>” separator |
| brand | String | — | Product brand | OpenAI | Required for all excluding movies, books, and musical recording brands | — | Max 70 chars |
| material | String | — | Primary material(s) | Leather | Required | — | Max 100 chars |
| dimensions | String | LxWxH unit | Overall dimensions | 12x8x5 in | Optional | — | Units required if provided |
| length | Number + unit | — | Individual dimension | 10 mm | Optional | Provide all three if using individual fields | Units required |
| width | Number + unit | — | Individual dimension | 10 mm | Optional | Provide all three if using individual fields | Units required |
| height | Number + unit | — | Individual dimension | 10 mm | Optional | Provide all three if using individual fields | Units required |
| weight | Number + unit | — | Product weight | 1.5 lb | Required | — | Positive number with unit |
| age_group | Enum | newborn, infant, toddler, kids, adult | Target demographic | adult | Optional | — | Lower-case string |
Media
Supply visual and rich media assets that represent the product. High-quality images and optional videos or 3D models improve user trust and engagement.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| image_link | URL | RFC 1738 | Main product image URL | https://example.com/image1.jpg | Required | — | JPEG/PNG; HTTPS preferred |
| additional_image_link | URL array | RFC 1738 | Extra images | https://example.com/image2.jpg,… | Optional | — | Comma-separated or array |
| video_link | URL | RFC 1738 | Product video | https://youtu.be/12345 | Optional | — | Must be publicly accessible |
| model_3d_link | URL | RFC 1738 | 3D model | https://example.com/model.glb | Optional | — | GLB/GLTF preferred |
Price & Promotions
Define standard and promotional pricing information. These attributes power price display, discount messaging, and offer comparisons.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| price | Number + currency | ISO 4217 | Regular price | 79.99 USD | Required | — | Must include currency code |
| applicable_taxes_fees | Number + currency | ISO 4217 | Additional taxes/fees | 7 USD | Optional | — | — |
| sale_price | Number + currency | ISO 4217 | Discounted price | 59.99 USD | Optional | — | Must be ≤ price |
| sale_price_effective_date | Date range | ISO 8601 | Sale window | 2025-07-01 / 2025-07-15 | Optional | Required if sale_price provided | Start must precede end |
| unit_pricing_measure / base_measure | Number + unit | — | Unit price & base measure | 16 oz / 1 oz | Optional | — | Both fields required together |
| pricing_trend | String | — | Lowest price in N months | Lowest price in 6 months | Optional | — | Max 80 chars |
Availability & Inventory
Describe current stock levels and key timing signals for product availability. Accurate inventory data ensures users only see items they can actually purchase.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| availability | Enum | in_stock, out_of_stock, preorder | Product availability | in_stock | Required | — | Lower-case string |
| availability_date | Date | ISO 8601 | Availability date if preorder | 2025-12-01 | Required if availability=preorder | — | Must be future date |
| inventory_quantity | Integer | — | Stock count | 25 | Required | — | Non-negative integer |
| expiration_date | Date | ISO 8601 | Remove product after date | 2025-12-01 | Optional | — | Must be future date |
| pickup_method | Enum | in_store, reserve, not_supported | Pickup options | in_store | Optional | — | Lower-case string |
| pickup_sla | Number + duration | — | Pickup SLA | 1 day | Optional | Requires pickup_method | Positive integer + unit |
Variants
Specify variant relationships and distinguishing attributes such as color or size. These fields allow ChatGPT to group related SKUs and surface variant-specific details.
The item_group_id value should represent how the product is presented on the merchant’s website (the canonical product page or parent listing shown to customers). If you are submitting variant rows (e.g., by color or size), you must include the same item_group_id for every variant. Do not submit individual variant SKUs without a group id.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| item_group_id | String | — | Variant group ID | SHOE123GROUP | Required if variants exist | — | Max 70 chars |
| item_group_title | String (UTF-8 text) | — | Group product title | Men's Trail Running Shoes | Optional | — | Max 150 chars; avoid all-caps |
| color | String | — | Variant color | Blue | Recommended (apparel) | — | Max 40 chars |
| size | String | — | Variant size | 10 | Recommended (apparel) | — | Max 20 chars |
| size_system | Country code | ISO 3166 | Size system | US | Recommended (apparel) | — | 2-letter country code |
| gender | Enum | male, female, unisex | Gender target | male | Recommended (apparel) | — | Lower-case string |
| offer_id | String | — | Offer ID (SKU+seller+price) | SKU12345-Blue-79.99 | Recommended | — | Unique within feed |
| Custom_variant1_category | String | — | Custom variant dimension 1 | Size_Type | Optional | — | — |
| Custom_variant1_option | String | — | Custom variant 1 option | Petite / Tall / Maternity | Optional | — | — |
| Custom_variant2_category | String | — | Custom variant dimension 2 | Wood_Type | Optional | — | — |
| Custom_variant2_option | String | — | Custom variant 2 option | Oak / Mahogany / Walnut | Optional | — | — |
| Custom_variant3_category | String | — | Custom variant dimension 3 | Cap_Type | Optional | — | — |
| Custom_variant3_option | String | — | Custom variant 3 option | Snapback / Fitted | Optional | — | — |
Fulfillment
Outline shipping methods, costs, and estimated delivery times. Providing detailed shipping information helps users understand fulfillment options upfront.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| shipping | String | country:region:service_class:price | Shipping method/cost/region | US:CA:Overnight:16.00 USD | Required where applicable | — | Multiple entries allowed; use colon separators |
| delivery_estimate | Date | ISO 8601 | Estimated arrival date | 2025-08-12 | Optional | — | Must be future date |
Merchant Info
Identify the seller and link to any relevant merchant policies or storefront pages. This ensures proper attribution and enables users to review seller credentials.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| seller_name | String | — | Seller name | Example Store | Required / Display | — | Max 70 chars |
| seller_url | URL | RFC 1738 | Seller page | https://example.com/store | Required | — | HTTPS preferred |
| seller_privacy_policy | URL | RFC 1738 | Seller-specific policies | https://example.com/privacy | Required, if enabled_checkout is true | — | HTTPS preferred |
| seller_tos | URL | RFC 1738 | Seller-specific terms of service | https://example.com/terms | Required, if enabled_checkout is true | — | HTTPS preferred |
Returns
Provide return policies and time windows to set clear expectations for buyers. Transparent return data builds trust and reduces post-purchase confusion.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| return_policy | URL | RFC 1738 | Return policy URL | https://example.com/returns | Required | — | HTTPS preferred |
| return_window | Integer | Days | Days allowed for return | 30 | Required | — | Positive integer |
Performance Signals
Share popularity and return-rate metrics where available. These signals can be used to enhance ranking and highlight high-performing products.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| popularity_score | Number | — | Popularity indicator | 4.7 | Recommended | — | 0–5 scale or merchant-defined |
| return_rate | Number | Percentage | Return rate | 2% | Recommended | — | 0–100% |
Compliance
Include regulatory warnings, disclaimers, or age restrictions. Compliance fields help meet legal obligations and protect consumers.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| warning / warning_url | String / URL | — | Product disclaimers | Contains lithium battery, or CA Prop 65 warning | Recommended for Checkout | — | If URL, must resolve HTTP 200 |
| age_restriction | Number | — | Minimum purchase age | 21 | Recommended | — | Positive integer |
Reviews and Q&A
Supply aggregated review statistics and frequently asked questions. User-generated insights strengthen credibility and help shoppers make informed decisions.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| product_review_count | Integer | — | Number of product reviews | 254 | Recommended | — | Non-negative |
| product_review_rating | Number | — | Average review score | 4.6 | Recommended | — | 0–5 scale |
| store_review_count | Integer | — | Number of brand/store reviews | 2000 | Optional | — | Non-negative |
| store_review_rating | Number | — | Average store rating | 4.8 | Optional | — | 0–5 scale |
| q_and_a | String | — | FAQ content | Q: Is this waterproof? A: Yes | Recommended | — | Plain text |
| raw_review_data | String | — | Raw review payload | — | Recommended | — | May include JSON blob |
Related Products
List products that are commonly bought together or act as substitutes. This enables basket-building recommendations and cross-sell opportunities.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| related_product_id | String | — | Associated product IDs | SKU67890 | Recommended | — | Comma-separated list allowed |
| relationship_type | Enum | part_of_set, required_part, often_bought_with, substitute, different_brand, accessory | Relationship type | part_of_set | Recommended | — | Lower-case string |
Geo Tagging
Indicate any region-specific pricing or availability overrides. Geo data allows ChatGPT to present accurate offers and stock status by location.
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| geo_price | Number + currency | Region-specific price | Price by region | 79.99 USD (California) | Recommended | — | Must include ISO 4217 currency |
| geo_availability | String | Region-specific availability | Availability per region | in_stock (Texas), out_of_stock (New York) | Recommended | — | Regions must be valid ISO 3166 codes |