Hubkeeper
AI visibility checkerSee if ChatGPT recommends youFeed generatorStore URL to a ChatGPT product feedFeed validatorCheck a feed before you upload itAll tools
Guides
Run a free check

Tools

AI visibility checkerSee if ChatGPT recommends youFeed generatorStore URL to a ChatGPT product feedFeed validatorCheck a feed before you upload itAll toolsGuidesRun a free check
Guides/Product feed spec

ChatGPT Business Hub product feed: format, required fields and common errors

Updated 2026-11-17

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

FieldRule
item_idStable, unique per item or variant. Never reuse. Aliases id and sku are accepted.
titleProduct name including the variant when relevant. Aim for 150 characters or fewer.
descriptionPlain, factual text. Aim for 5,000 characters or fewer. No HTML.
urlAbsolute, public product page. HTTPS preferred.
brandThe brand as shown on the product page, not a placeholder.
seller_nameName of the seller, on every row.
image_urlDirect, public image URL showing this variant.
availabilityExactly 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.

FieldRequired whenRule
group_idThe row is a variantSame 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_variationsThe row is a varianttrue on every variant row.
variant_dictThe row is a variantIgnored unless listing_has_variations is true and group_id differs from item_id.
dimensions_unitYou send length, width or heightOne unit for all three.
item_weight_unitYou send weightThe unit of that weight.
is_ads_eligibleThe feed is used for ChatGPT AdsEmpty means not processed for Ads, unless a feed-level Ads default applies. Separate from search eligibility.
is_eligible_checkoutYou opt into checkouttrue only when search eligibility is also true and checkout is enabled for your integration.
seller_privacy_policy, seller_tosCheckoutFull URLs of your privacy policy and terms.
marketplace_sellerThird-party marketplace offersNeeds 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

Does ChatGPT recommend your business?

Enter your website. Hubkeeper asks ChatGPT 5 questions your customers might ask and shows who it recommends and which sources it cites. Free, no account.

Run the free check
Hubkeeper

Checks and tools for your business in ChatGPT.

© 2026 CENDRO LABS PTY LTD. Hubkeeper is not affiliated with OpenAI.

Tools

AI visibility checkerChatGPT product feed generatorChatGPT product feed validatorAll tools

Business Hub guides

Verification failedVerification by countryClaim your businessProduct feed specKeep your feed up to dateAll guides

Legal

TermsPrivacyAcceptable useContact