Elbuz builds a product feed for ChatGPT ads to the OpenAI schema and uploads it to the OpenAI SFTP server. Columns in the ready-made “OpenAI (ChatGPT Ads)” template are named and filled as OpenAI requires — no manual setup.
When you need this:
- You’re launching product ads in ChatGPT — a CSV with 17 OpenAI fields, price with currency code and availability.
- Prices and stock change daily — the schedule builds a fresh file every day and puts it on SFTP.
- OpenAI added a new field — add a regular column named after it.
Where to start: “Data export” → “Add” → “OpenAI (ChatGPT Ads)”, then the first launch scenario.
What the OpenAI template can do
- 17 ready-made columns — each column name matches an OpenAI field; the app calculates the price with currency, availability, photos and description.
- Availability —
in_stock,pre_orderorout_of_stock, based on quantity and the stock status type. - SFTP upload — after each export, the file replaces the previous one on the OpenAI server.
- Test export of one product — shows the value of each column and sends nothing.
- Schedule — daily price and availability updates without your involvement.
- New fields — any field from the OpenAI schema can be added as a regular column.
What OpenAI accepts and requires
OpenAI accepts a product file in CSV (comma-separated), TSV or JSONL format with encoding. The Elbuz template produces a comma-separated CSV.
Delivery is via SFTP only: OpenAI doesn’t fetch a feed by URL the way Google Merchant Center does. OpenAI issues the connection address and password once feed access is enabled for your ads account. If you don’t have that access, OpenAI recommends contacting its account support team — it can’t be enabled in Elbuz.
Required fields — OpenAI won’t accept a product without them:
| Field | OpenAI requirement |
|---|---|
item_id | a stable identifier, unique within the file |
title | name, up to 150 characters |
description | description in plain text without , up to 5000 characters |
url | the product page on your website, a public HTTP or HTTPS address (OpenAI recommends HTTPS) |
brand | the real brand name, no placeholders |
seller_name | seller name |
image_url | a direct link to a JPEG or PNG photo |
availability | one of in_stock, out_of_stock, pre_order, backorder, unknown |
price | amount and currency code separated by a space: 79.99 USD |
OpenAI forbids placeholders such as n/a or null: leave an unknown optional field empty.
How to create a template
Where: “Data export” → “Add” button → “Price list file (XLSX, CSV)” group → “OpenAI (ChatGPT Ads)”.
1
Price list file (XLSX, CSV) group2
OpenAI (ChatGPT Ads)- Price list file (XLSX, CSV) — the OpenAI feed is a CSV file, so it sits in this group.
- OpenAI (ChatGPT Ads) — a click creates a template with the columns already set up.
Right after creation, the “Advanced settings OpenAI (ChatGPT Ads) #‹template number›” window opens. CSV with commas is already on, archiving is off, and the file name is openai_products.csv. Above the column list, a hint shows what is still left to set up by hand.
A product goes into the file if it is all of the following:
- enabled;
- marked “Export to file (to website)”;
- in a category marked for export;
- has a description in the template language — a product with no description record in the selected language is left out of the file entirely.
You can narrow the set further on the “Export limit (filter)” tab. How filter conditions work: Where the product filter is set.
What goes into the file
The “Select fields” tab has 17 columns. Each column name is an OpenAI field name, and the columns go into the file in this order.
1
Setup hint2
Field name column3
url formula4
price macro- Setup hint — what is still left to do by hand: your site address, store name and manufacturer.
- Field name — the column name in the file equals the OpenAI field name.
- url formula — replace https://site.com/ with the address of your own site.
- price — source is Macros: the program builds the amount with currency, so there is no formula to write.
| Column | What goes into it |
|---|---|
item_id | the product in Elbuz — doesn’t change between exports |
title | the full product name in the template language; if it’s longer than 150 characters, shorten it in the catalog |
description | the full description without HTML tags, cut to 5000 characters; ", – and similar codes become regular quotes and dashes |
url | website address + the product SEO URL |
brand | the product manufacturer |
image_url | link to the first product photo |
additional_image_urls | links to the other photos, comma-separated |
price | the price in your account’s default currency: 976.00 UAH |
sale_price | the sale price in the same format — only when it’s above zero and below the regular price, otherwise empty |
availability | in_stock, pre_order or out_of_stock — see the rule below |
gtin | the product , or the barcode if GTIN is empty |
mpn | manufacturer part number |
product_category | category path, levels separated by > |
seller_name | store name — as text in the column formula |
seller_url | website address — as text in the column formula |
is_eligible_search | true |
is_ads_eligible | true — without it, OpenAI won’t use the product in ads |
The app itself calculates the price, availability, photos, description and barcode: the column holds a system field, not a formula, so accidental editing can’t break it. The currency and the stock status list are read on every export — if you change the default currency, the next file will already use the new one.
How availability is determined
in_stock— the product quantity is above zero or the product’s stock status has the “In stock” type.pre_order— otherwise, if the status type is “On order”.out_of_stock— in all other cases.
The status type is set in the stock status list.
How to add a new OpenAI field
The template is a regular price list, so you can add, delete or change any column. When OpenAI starts accepting a new field, or you want to fill in an optional one, click “Add field to export” and name the column exactly as the field in the OpenAI schema.
Example: the condition field (product condition). Add “Custom formula”, name the column condition and enter "new" in the formula — every row of the file will have new.
The system fields “Price with currency (79.99 USD)”, “Availability code (in_stock / out_of_stock / pre_order)”, “Main product photo link”, “Full description as plain text (no HTML, up to 5000 characters)” and others are also available in a regular price list — they come in handy for CSV feeds of other marketplaces.
What you need to fix by hand
The app doesn’t know two things about your business, so you have to enter them yourself.
Website address. The app takes it from the main store settings. If it’s empty there, the url and seller_url columns contain https://site.com/. Click the “Formula” cell in the column row and replace this address with yours. In url, keep the product SEO URL macro after the address — it appends the path to the specific product.
Store name. The seller_name column gets the main store name. If it’s still the default name, replace it in the formula with the real one: OpenAI requires the actual seller name.
brand field is required. Products without a manufacturer will have it empty, and OpenAI will reject them. Fill in the manufacturer in the catalog before the first export.How to send the file to OpenAI SFTP
Where: “Settings” tab → “Related settings” block → “FTP Setup”.
1
SFTP checkbox2
Server address and port3
Username and password4
Check Connection- Tick SFTP: OpenAI accepts the file over SFTP only.
- Enter the server address and port from the connection details issued by OpenAI.
- Enter the username and password issued by OpenAI.
- Check Connection tests the entered access before the first export.
- Turn on “SFTP (SSH File Transfer Protocol)”.
- In “FTP server address”, enter the server from the OpenAI connection address, and in “Port” — the port from the same address. For SFTP, the app uses the port as is and doesn’t switch 21 to 22 on its own.
- In “Username” and “Password” — the login and password from OpenAI.
- Leave “Destination path” empty: OpenAI expects the file in the SFTP root, without subfolders.
- Click “Check Connection”.
After each export, openai_products.csv is placed in this folder under the same name and replaces the previous one. Upload happens only when both the server and the username are filled in: if either is empty, the file is built but not sent anywhere, and the log shows no error.
How to test the template and run the first export
The flask button in the template window header runs a test export of one product: it shows each column with its value. The file isn’t sent anywhere. Check url — the link should open — and price with the currency.
1
price line2
availability line3
url line- price — the amount and the currency code separated by a space.
- availability — the stock code that OpenAI understands (in_stock).
- url — check that the link leads to your own site.
A full export is started with the “Export this template” button in the template row. After a successful upload, the log shows “Files exported via FTP: 1 of 1”. What else the run log shows: Run log and run history.
Before the first export
How to update prices daily
Prices and availability in OpenAI are updated only by a new file. To have it arrive on its own, turn on the schedule.
Where: “Settings” tab → “Related settings” → “Schedule”.
Each scheduled run builds the file again from current catalog data and uploads it to SFTP. How the schedule works: Manual and scheduled runs.
Scenarios
First launch of product ads in ChatGPT
- What to set up: “Add” → “OpenAI (ChatGPT Ads)”; your website and store name in the
url,seller_urlandseller_nameformulas; “FTP Setup” with the SFTP checkbox and OpenAI details → “Check Connection”; a test export of one product. - Result: “Export this template” builds
openai_products.csvand puts it in the OpenAI SFTP root; the log shows “Files exported via FTP: 1 of 1”.
Daily price and availability updates
- What to set up: “Schedule” in the “Related settings” block.
- Result: each run builds the file from current prices and stock and replaces the previous one on SFTP.
Advertising only part of the catalog
- What to set up: conditions on the “Export limit (filter)” tab.
- Result: only products that pass the filter go into the file; the rest won’t appear in OpenAI ads.
OpenAI started accepting a new field
- What to set up: “Add field to export” → “Custom formula”, column name = OpenAI field name (condition example).
- Result: the new field goes into the file starting with the next export.
What to do when OpenAI rejects products
| What you see | Why | What to do |
|---|---|---|
| “SFTP server login failed!” in the log | Wrong login or password. If the text is followed by “Cannot connect to …”, the app couldn’t reach the server: wrong address or port | Compare the details with the OpenAI connection address and click “Check Connection” (SFTP upload) |
| The file is built, but there’s no “Files exported via FTP” line and no error | The server or username is empty in “FTP Setup” | Fill in both fields (SFTP upload) |
url contains https://site.com/… |
The main store has no website address | Replace the address in the url and seller_url formulas (what to fix) |
OpenAI rejects products because brand is empty |
The products have no manufacturer | Fill in the manufacturer in the catalog (what to fix) |
The product is in stock, but the file says out_of_stock |
The quantity is zero, and the product’s stock status type isn’t “In stock” | Change the status type in the stock status list (how availability is determined) |
| The product is missing from the file | It has no description in the template language, or one of the filter conditions excludes it | Check the file contents conditions and why a product didn’t make it into the file |
FAQ
Can I give OpenAI a file link instead of SFTP?
No. OpenAI accepts the product file via SFTP only. It doesn’t fetch the cloud file link that Elbuz creates after an export.
Will a comma in a product name break the file?
No. The app wraps values containing commas or quotes in quotes and doubles quotes inside them — this is the CSV standard, and OpenAI reads such rows correctly. Line breaks and tabs in descriptions are replaced with a space.
What currency is the price in?
Your account’s default currency, with its code added to the amount: 976.00 UAH. After you change the default currency, the next file will use the new one.
How often are prices updated in OpenAI?
As often as you export the file: between exports, OpenAI sees the previous prices and availability. Elbuz doesn’t use the OpenAI fast update channel (Delta ). For daily updates, turn on the schedule.
Can I export product variants as one group?
No. Each product goes as a separate row: the template’s field set has no group_id or variant_dict.
Can I export names and descriptions in English?
Yes, if the catalog has English texts. Choose the language on the “Settings” tab in the “Language ID” field: title and description are taken in that language. A product without an English description won’t go into the file at all.
Where to find it and who has access
- Menu
- Directories → Operations → Data export
- Other entry points
- the pencil in the template row opens the “Advanced settings …” card
- Access right
- the “Export” and “Export Template Setup” windows
- Have ready
- feed access in your OpenAI ads account and SFTP details from OpenAI
Without the “Export Template Setup” right, you can see the template in the list but can’t configure it: the card, the test export and are all behind this right.
Related topics
- If you need to understand why a template didn’t run or a product didn’t make it into the file — Exporting products to a marketplace, website or file.
- If you also need a Google Shopping feed — Google Merchant feed.
- If a product is in stock but the feed says
out_of_stock— Stock statuses. - If products have no photo, which OpenAI requires — Product photos.
