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.
| Field | What to put in it | Example |
|---|---|---|
item_id | Stable ID, unique per item or variant. Never reuse it for a different item. | TRAIL-BLK-10 |
title | Product name, including the selected variant when relevant. Aim for at most about 150 characters. | Trail running shoes - black, size 10 |
description | Factual plain-text description. Aim for at most about 5,000 characters. | Waterproof trail shoes with a rubber outsole. |
url | Product detail page, with the variant selected when possible. | https://example.com/products/trail?color=black&size=10 |
brand | Brand as shown on the product page. No placeholders. | Northline |
seller_name | Name of the seller supplying the offer. | Northline Outdoor |
image_url | Main image for this variant, as a direct image URL (JPEG, PNG and so on). | https://example.com/images/trail-black.jpg |
availability | in_stock, out_of_stock, pre_order, backorder or unknown. Anything else rejects the row. | in_stock |
price | Regular price in major units: amount, space, currency code. | 79.99 USD |
target_countries | Uppercase two-letter codes. Standard uploads use US. | ["US"] |
store_country | Country 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.