ChatGPT Business Hub product feed: format, required fields and common errors
Verified businesses can give ChatGPT a self-service product feed with prices and stock. Shopify stores connect and sync automatically; everyone else uploads a file that follows the OpenAI product feed specification. This page condenses that spec into what you need to produce a file that passes.
File format
- CSV, TSV or JSONL, UTF-8 encoded. One row or one JSON object per item or variant.
- In CSV, quote any cell that contains a comma, a quote or a newline, and double embedded quotes. Objects and arrays inside a cell are written as JSON text.
- Booleans are lowercase
true/false. Empty means "no value"; never write null, n/a or none as a placeholder. - Identifiers stay strings so leading zeros survive.
- A standard upload targets the US. Other markets need OpenAI to confirm the integration first.
The nine required fields
| Field | Rule |
|---|---|
item_id | Stable, unique per item or variant. Never reuse. Aliases id and sku are accepted. |
title | Product name including the variant when relevant. Aim for 150 characters or fewer. |
description | Plain, factual text. Aim for 5,000 characters or fewer. No HTML. |
url | Absolute, public product page. HTTPS preferred. |
brand | The brand as shown on the product page, not a placeholder. |
seller_name | Name of the seller, on every row. |
image_url | Direct, public image URL showing this variant. |
availability | Exactly one of in_stock, out_of_stock, pre_order, backorder, unknown. Anything else rejects the row. |
price | "amount CURRENCY", for example 79.99 USD. Positive regular price. |
The spec also lists target_countries (for example ["US"]) and store_country (US) as required geo fields. Standard uploads use the US values; add them when in doubt.
Conditionally required fields
These are required only in the cases listed. Leave them out otherwise.
| Field | Required when | Rule |
|---|---|---|
group_id | The row is a variant | Same value on every variant of one product, different from item_id. Left empty, it falls back to item_id and no group is formed. |
listing_has_variations | The row is a variant | true on every variant row. |
variant_dict | The row is a variant | Ignored unless listing_has_variations is true and group_id differs from item_id. |
dimensions_unit | You send length, width or height | One unit for all three. |
item_weight_unit | You send weight | The unit of that weight. |
is_ads_eligible | The feed is used for ChatGPT Ads | Empty means not processed for Ads, unless a feed-level Ads default applies. Separate from search eligibility. |
is_eligible_checkout | You opt into checkout | true only when search eligibility is also true and checkout is enabled for your integration. |
seller_privacy_policy, seller_tos | Checkout | Full URLs of your privacy policy and terms. |
marketplace_seller | Third-party marketplace offers | Needs setup with OpenAI. |
Everything else in the spec is optional, including gtin, mpn, sale_price and condition. Optional fields still have to be valid when you send them: a GTIN must have 8, 12, 13 or 14 digits and a correct check digit, and used or refurbished items should say so in condition.
Price format, precisely
Money is a string: a decimal amount in major units, one space, then an uppercase three-letter ISO 4217 code. Use a decimal point, no thousands separators, no exponent, and no more fractional digits than the currency allows (two for USD, none for JPY). Do not round into a different payable amount.
- Correct:
24.00 USD,1299.99 USD,3500 JPY - Rejected:
$24,24,USD 24,24,00 EUR,1,299.99 USD,24.00usd
sale_price uses the same format and must be greater than zero, less than price and in the same currency, or it is ignored. shipping_price must be non-negative; omitted means unknown, not free.
Variants
Each variant is its own row with its own item_id. Give every variant of one product the same group_id (alias item_group_id), which must differ from the item_id, set listing_has_variations to true on every variant row, and describe the selected options in variant_dict, for example {"color":"Red","size":"M"}. Google-style Custom_variant1_category / Custom_variant1_option column pairs are also accepted.
Errors that reject rows, and what to change
The ChatGPT product feed validator finds each of these in your file and names the rows, and the product feed generator avoids them by building the file from your store. The most common:
- A required column missing from the header rejects the whole file. Google Merchant exports name things differently: rename link to url, image_link to image_url, product_type to product_category.
- Availability written as "In Stock", "yes" or "1". Map your stock status to the five allowed values.
- Price with a symbol or without a currency code. Export the currency explicitly.
- Duplicate item_ids, usually from exporting the parent product and its variants with the same ID.
- Placeholder brand values such as n/a or Generic.
- Unescaped commas in titles and descriptions, which shift every later cell by one column.
Keeping it fresh
Sale and availability dates in the feed do not schedule changes; OpenAI reads the values as they are at upload time. That means a price change or a sell-out needs a new upload; the steps are in how to keep your feed up to date. Rebuild the file from your store with the product feed generator, or check every export with the validator before you upload, and read the full field reference at developers.openai.com.
More guides
- ChatGPT Business Hub verification failed: why it happens and what to do
- ChatGPT Business Hub outside the US: verification status by country
- How to claim your business in ChatGPT (Business Hub walkthrough)
- How to keep your ChatGPT product feed prices and stock up to date
- ChatGPT Business Hub insights explained: mentions, clicks and how to keep history
- ChatGPT Business Agents: who is eligible and what an agent can do