What fields does a Meta product catalog feed need?
Each product row needs id, title, description, availability, condition, price, link and image_link, plus at least one of brand, GTIN or MPN. Field names must stay in US English and match Meta's specification exactly. Prices take a number, a space and a three-letter currency code, such as 9.99 USD.
A data feed is a spreadsheet or XML file with one product per row and one attribute per column. Each column in the header row represents one product attribute, and Meta says the field names must stay in US English and match its specifications exactly. Commerce Manager offers a template to start from when you add a data file.
Which fields are required?
| Field | What it holds | Rules from Meta |
|---|---|---|
| id | A unique content ID, ideally the SKU | Up to 100 characters; each ID appears only once |
| title | The product name | Up to 200 characters; under 65 recommended to avoid truncation |
| description | What the product is | Plain text, 30 to 9,999 characters, not all capitals |
| availability | Stock status | in stock or out of stock |
| condition | Item condition | new, refurbished or used |
| price | Full price | Number, space, ISO 4217 code, with a period for decimals, such as 9.99 USD |
| link | The product’s page on your website | Must begin with http:// or https:// |
| image_link | The main product image | JPEG or PNG, at least 500 x 500 pixels, up to 8 MB |
| brand | Brand name | Up to 100 characters |
Meta’s troubleshooting page adds that you must give at least one of brand, GTIN or MPN to identify each product, and that a GTIN must be in UPC, EAN, JAN, ISBN or ITF-14 format.
Which file formats can you use?
XLSX, CSV, TSV, XML (RSS/Atom) or Google Sheets. For Google Sheets, the feed must be on the first tab, and Meta says any other tabs are ignored.
Which optional fields control sales, status and variants?
| Field | Use | Rules from Meta |
|---|---|---|
| sale_price | A discounted price | Must be lower than price or it won’t show; same format as price |
| sale_price_effective_date | When the sale runs | Start and end in the format YYYY-MM-DDT23:59+00:00/YYYY-MM-DDT23:59+00:00 |
| status | Hide or show a product | active or archived; blank means active |
| item_group_id | Links variants of one product | Same value for all variants; must differ from every content ID |
How do you build a feed from Meta’s template?
- Go to Commerce Manager, select your catalog and open Products or Data sources.
- Click + Add, select Data file and click Download template.
- Pick the standard XLSX or CSV template, or a custom template with category-specific fields.
- Delete the example rows and add one product per row.
- Fill every required field, keeping optional ones or deleting them.
- Save the file and upload it to your catalog.
FAQ
Can I use a currency symbol in the price field?
No. Meta says not to include symbols such as $. Write the number, a space and the three-letter ISO 4217 code, and always use a period as the decimal point, never a comma, whatever your currency.
How do I remove a sale price?
If your feed uses the update upload setting, Meta says to set sale_price to 0 or leave it empty and upload, rather than deleting the column. After that upload you can drop the field. Without an effective date, a sale price stays live until removed.
Can I upload a feed built for Google Merchant Center?
Yes. When you add a data file, Commerce Manager is selected by default under the platform your file is formatted for. Meta says to choose Google Merchant Center instead if your file is formatted for advertising on Google.
Sources
- Catalog fields reference (Meta for Developers) (Meta, checked 2 Oct 2026)
- Create a data feed for your catalog using a template (Meta, checked 2 Oct 2026)
- Troubleshoot data feed errors in your catalog (Meta, checked 2 Oct 2026)
- Edit product availability and prices using a data feed (Meta, checked 2 Oct 2026)
- Product description specifications for catalogs (Meta, checked 2 Oct 2026)
- Upload products to your catalog with a data feed in Commerce Manager (Meta, checked 2 Oct 2026)
Drafted with AI and checked claim by claim against the pages linked under Sources. Found a mistake? Tell us via the corrections policy.