Feed Checkup

OpenAI product feed: the 11 required fields

Every row in an OpenAI-format product feed needs these fields. This is our plain-English summary of OpenAI's product feed reference; the reference also lists many optional fields for variants, shipping, returns and reviews.

FieldWhat to put in itExample
item_idStable ID, unique per item or variant. Never reuse it for a different item.TRAIL-BLK-10
titleProduct name, including the selected variant when relevant. Aim for at most about 150 characters.Trail running shoes - black, size 10
descriptionFactual plain-text description. Aim for at most about 5,000 characters.Waterproof trail shoes with a rubber outsole.
urlProduct detail page, with the variant selected when possible.https://example.com/products/trail?color=black&size=10
brandBrand as shown on the product page. No placeholders.Northline
seller_nameName of the seller supplying the offer.Northline Outdoor
image_urlMain image for this variant, as a direct image URL (JPEG, PNG and so on).https://example.com/images/trail-black.jpg
availabilityin_stock, out_of_stock, pre_order, backorder or unknown. Anything else rejects the row.in_stock
priceRegular price in major units: amount, space, currency code.79.99 USD
target_countriesUppercase two-letter codes. Standard uploads use US.["US"]
store_countryCountry of the seller's store. Standard uploads use US.US

A minimal valid record (JSON Lines)

This is OpenAI's own minimal example from the reference, shown here for convenience.

{"item_id":"MUG-350-BLUE","title":"Blue ceramic mug, 350 mL","description":"Dishwasher-safe glazed ceramic mug with a handle.","url":"https://example.com/products/mug-blue","brand":"Northline","seller_name":"Northline Home","image_url":"https://example.com/images/mug-blue.jpg","price":"18.00 USD","availability":"in_stock","target_countries":["US"],"store_country":"US"}

How to submit

OpenAI's submit product feeds guide says businesses start in Business Hub, verify their identity, choose countries and currencies, prepare the feed, and pick one delivery method: manual upload, a hosted HTTPS URL or SFTP.

Questions

How many fields are required in an OpenAI product feed?

OpenAI's product feed reference lists 11 required fields: item_id, title, description, url, brand, seller_name, image_url, availability, price, target_countries and store_country.

What price format does OpenAI use?

An amount in major currency units, a space, and a three-letter currency code, such as 79.99 USD.

Which file formats can I upload?

OpenAI's product feed reference gives formatting rules for CSV and TSV files and shows JSON Lines examples. Its submit guide lists three delivery methods: manual upload, a hosted HTTPS URL or SFTP. Check OpenAI's guides for the current options.

Checked against OpenAI's product feed reference on November 17, 2026. OpenAI updates the spec; follow the link for the current rules.