Product Feed Spec
Provide a structured product feed so ChatGPT accurately indexes and displays your products with up-to-date price and availability.
Note: Building with the Agentic Commerce Protocol is open to all. Instant Checkout in ChatGPT is currently available to approved partners. To apply to participate in Instant Checkout, fill out this form here.
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. |
[Content continues with detailed field references...]
| Attribute | Data Type | Supported Values | Description | Example | Requirement | Dependencies | Validation Rules |
|---|---|---|---|---|---|---|---|
| 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 |
[Content continues...]