Facebook Product Feed: Meta Catalog Specs, Template and Examples (2026)

A Facebook product feed is a file of your products that Meta reads into a catalog in Commerce Manager, so they can show in your ads and shops on Facebook and Instagram. Each product needs nine fields: id, title, description, availability, condition, price, link, image_link and brand (plus size for clothing and shoes sold in Shops). Meta takes CSV, TSV, XLSX, Google Sheets or XML.

The template and examples on this page show what Meta expects the file to look like. If you run a WooCommerce store, don’t maintain that file as a sheet: generate the feed from your products with CTX Feed, which keeps it updated at a URL Meta fetches on a schedule. Below you’ll find Meta’s current limits field by field, the CTX Feed setup, CSV and XML examples, and a fix for each error Commerce Manager shows.

What changed in Meta’s spec recently, if your feed was built from an older guide:

• availability now accepts only in stock and out of stock. Older guides, including the previous version of this page, listed five values.
• There’s a new set of direct checkout fields, native_commerce and product_disclosures.
• Meta now recommends internal_label instead of custom_label_0–4 for building product sets.
• quantity_to_sell_on_facebook only matters for Shops on Facebook and Instagram.

What is a Facebook (Meta) product feed?

A catalog holds the products you advertise and sell across Meta’s apps, and a data feed is the file that fills it. Meta calls a feed “a file containing product data that you upload to your catalog”, either once or on a schedule.

One product catalog powers several things:

• Advantage+ catalog ads show each person your most relevant products, based on their interests and actions.
• Shops are a storefront on Facebook and Instagram, where you feature products or collections.
• Product tags make your Instagram ads shoppable.
• Collection and carousel ads can pull their products from the catalog.

So one feed covers Facebook and Instagram. You don’t build a separate Instagram feed.

Facebook product feed specifications (2026)

All field names, and some values, must be in US English. The tables below follow Meta’s Product data specifications for catalogs page, checked on 19 October 2026.

Required fields

Out-of-stock products don’t show in your ads. They stay in your Facebook and Instagram shops for up to 56 days, marked “sold out”.

Prices: one currency per file. To sell in other currencies, upload a country feed.

Required fields for direct checkout

Meta lists two fields for selling through direct checkout (agentic commerce), which Meta says “is not available to everyone yet”.

• native_commerce: true makes the product eligible for direct checkout. false, or leaving it blank, means it isn’t.
• product_disclosures: compliance disclosures such as California Proposition 65 warnings or choking hazards. Each disclosure has subfields (content is required; title, symbol, jurisdictions and others are optional), numbered product_disclosures[0], [1]… up to 20 per product.

If direct checkout isn’t open to your account yet, leave both out.

Optional fields

Meta recommends sending as much relevant data as you can. These are the ones store owners use most:

Meta for Developers lists more optional fields.

Clothing and other variant products

Meta’s spec only requires size, and only for Shops in categories such as clothing and shoes. color, gender and age_group are optional. For variants, give each one its own row and its own id, the same item_group_id, and the attributes that tell them apart (color, size, material, pattern, gender). Fill in the same attributes for every variant in the group.

Additional fields for selling in India

Meta adds these only for products you sell with Shops or on WhatsApp in India:

• origin_country: two-letter ISO country code.
• importer_name and importer_address, if the origin isn’t India. importer_address is a JSON structure with street1, city and country required.
• manufacturer_info: required for Shops.
• wa_compliance_category: WhatsApp only; COUNTRY_ORIGIN_EXEMPT for non-physical goods such as services.

CTX Feed writes importer_address as a JSON object. If you map plain text, it wraps the text as the street1 value.

Other catalog types

Hotels, flights, destinations, vehicles, real estate, streaming media, apps, publications, professional services and activities each have their own field lists. You pick the catalog type when you create the catalog, and you can’t switch it later.

Feed formats: CSV, TSV, XLSX, Google Sheets or XML

Limits for every format: 100 MB for a one-time upload, 4 GB for a scheduled feed, and 5 MB per line. Meta recommends up to 1 million items per feed; split bigger catalogs into several feeds.

For a store, the feed should be a file at a URL that Meta fetches on a schedule, hourly, daily or weekly, so the catalog follows your products. A sheet or XLSX file only changes when someone edits it.

CTX Feed generates the Facebook feed as XML, CSV or TXT (tab-separated, which is Meta’s TSV format), three of the formats Meta accepts.

How to create a Facebook product feed from WooCommerce with CTX Feed

CTX Feed builds the feed from your WooCommerce products and keeps it updated at a URL Meta can fetch.

Why not keep a sheet by hand?

A spreadsheet feed works until your store changes. Then it fails in four ways:

• Stale price and stock. For prices and availability, Meta suggests an hourly update schedule. A sheet is only as current as its last edit, so a product that sold out in WooCommerce stays in stock in your ads until someone fixes the row.
• Re-uploads. A one-time upload changes nothing until you upload again. Even a scheduled feed only fetches what’s in the file, and Meta lists the upkeep of a data feed as “Update data file as needed”.
• One row per variant. Every size and colour needs its own row, its own id and the shared item_group_id. A T-shirt in 4 colours and 5 sizes is 20 rows to keep in step.
• Rejected items. One in_stock, one $24.00 or one unquoted comma gets products flagged or rows misaligned.

CTX Feed reads the same data from WooCommerce every time it rebuilds the file on your Update interval. It can write each variation as its own row, with the parent product’s ID in item_group_id, and it writes values in Meta’s format (see the table below).

Set up the feed

Here’s the short version; the full guide with screenshots has every setting.

1. Go to CTX Feed → Manage Feeds and click Make Feed.
2. In Feed settings, choose the Facebook Catalog / Instagram template, the Country you sell to (required; it sets currency and tax handling), a File type, and an Update interval.

3. On the Config tab, Meta’s nine required fields are already mapped to WooCommerce data. Check two rows: condition is fixed to new, and brand is your site name, or Parent Brand if you use WooCommerce Brands.
4. Barcodes: WooCommerce 9.2 and later has its own GTIN, UPC, EAN, or ISBN field on the product’s Inventory tab, which you can map to gtin. For MPN, turn on CTX Feed’s identifier fields under System → Settings → Product attributes → Product identifiers.
5. Categories: build a mapping set under Data mapping → Category mapping with the Facebook taxonomy (you search Meta’s list as you type), then select it as the Value of your category row on the Config tab. Category mapping guide.
6. Optional: on the Filters tab, Product status is free. Removing out-of-stock or no-image products, or limiting the feed to some categories, needs CTX Feed Pro.
7. Click Save & generate. On Manage Feeds, click the Copy URL icon next to the feed’s URL and leave Auto Update on. Then add the URL to Commerce Manager.

What CTX Feed changes for Meta (and not for Google)

The Facebook template has its own field mapping, separate from the Google template. CTX Feed formats each value the way Meta’s spec asks:

All Meta attributes and the Facebook template are in the free version.

Upload your feed to Meta Commerce Manager

1. In Commerce Manager, select your catalog, open the Catalog tab and go to Products or Data sources.
2. Click + Add and select Data file. Leave Commerce Manager selected as the format your file follows.
3. Choose Use a URL or Google Sheets and paste your CTX Feed URL.
4. Name the feed and pick the default currency, used when a price has no currency code.
5. Choose an hourly, daily or weekly schedule, then click Upload.

A standard CTX Feed URL is public, so leave the username and password empty.

Replace or update? A Replace schedule (the default) adds, updates and deletes products to match your file. An Update schedule only adds and updates; products you drop from the file stay in the catalog.

Meta’s fetch schedule vs CTX Feed’s update interval

Two clocks run here: CTX Feed rebuilds the file, and Meta fetches it.

• CTX Feed: every 1h, 6h, 12h, 24h or 1w in the free version, or every 5, 15, 30 or 45 minutes with CTX Feed Pro.
• Meta: hourly, daily or weekly. Meta’s advice is to fetch shortly after your file updates, e.g. a 9:15 fetch for a file that updates at 9:00.

CTX Feed’s schedule starts from the moment you switch Auto Update on. To have a 24-hour feed rebuild at 02:00, toggle Auto Update off and on at 02:00, then set Meta’s daily fetch a little later.

What a Facebook feed file looks like: CSV template and XML example

These two files show the format Meta reads. They’re for reference: a store’s real feed should come from its products, as set up above.

Facebook product feed CSV template (example)

Here’s what the CSV looks like. The two T-shirt rows are variants of one product: they share an item_group_id and each has its own id. Only the first row is on sale, and its sale_price is lower than its price.

id,item_group_id,title,description,availability,condition,price,sale_price,link,image_link,brand,gtin,google_product_category,color,size,gender,age_group
"TSHIRT-BLU-M","TSHIRT-01","Organic Cotton T-Shirt, Blue, M","Relaxed-fit T-shirt in organic cotton. Cap sleeves.","in stock","new","24.00 USD","19.00 USD","https://example.com/product/organic-tshirt/?attribute_color=blue&attribute_size=m","https://example.com/images/tshirt-blue.jpg","Example Brand","","Apparel & Accessories > Clothing > Shirts & Tops","Blue","M","unisex","adult"
"TSHIRT-RED-L","TSHIRT-01","Organic Cotton T-Shirt, Red, L","Relaxed-fit T-shirt in organic cotton. Cap sleeves.","out of stock","new","24.00 USD","","https://example.com/product/organic-tshirt/?attribute_color=red&attribute_size=l","https://example.com/images/tshirt-red.jpg","Example Brand","","Apparel & Accessories > Clothing > Shirts & Tops","Red","L","unisex","adult"
"MUG-001","","Stoneware Coffee Mug","Hand-glazed stoneware mug, 350 ml. Dishwasher safe.","in stock","new","16.50 USD","","https://example.com/product/stoneware-mug/","https://example.com/images/mug.jpg","Example Brand","","Home & Garden > Kitchen & Dining > Tableware > Drinkware > Mugs","","","",""

Every value is in double quotes, so commas and spaces inside a value can’t shift the columns.

Template tips:

• availability is exactly in stock or out of stock: lowercase, with a space.
• price and sale_price are a number, a space and the currency code; no $.
• Leave gtin empty unless you’re sure the barcode is right.
• google_product_category takes the category name or its ID. Use a category from Google’s current list; the paths above are examples.
• Keep the header names exactly as Meta spells them.

Copy it to see the format. For a live store, CTX Feed builds and updates this file from WooCommerce automatically.

Facebook product feed XML example

Meta’s own sample “Products” XML file is an RSS 2.0 feed that declares Google’s namespace (xmlns:g) and wraps each product in <item>. This example follows the same structure:

<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:g="http://base.google.com/ns/1.0" version="2.0">
<channel>
<title>Example Store</title>
<link>https://example.com</link>
<description>Example Store product feed</description>
<item>
<g:id>TSHIRT-BLU-M</g:id>
<g:item_group_id>TSHIRT-01</g:item_group_id>
<g:title>Organic Cotton T-Shirt, Blue, M</g:title>
<g:description>Relaxed-fit T-shirt in organic cotton. Cap sleeves.</g:description>
<g:link>https://example.com/product/organic-tshirt/?attribute_color=blue&amp;attribute_size=m</g:link>
<g:image_link>https://example.com/images/tshirt-blue.jpg</g:image_link>
<g:brand>Example Brand</g:brand>
<g:condition>new</g:condition>
<g:availability>in stock</g:availability>
<g:price>24.00 USD</g:price>
<g:sale_price>19.00 USD</g:sale_price>
<g:google_product_category>Apparel &amp; Accessories &gt; Clothing &gt; Shirts &amp; Tops</g:google_product_category>
<g:color>Blue</g:color>
<g:size>M</g:size>
</item>
</channel>
</rss>

XML notes:

• Start with the <?xml declaration and put one field per line. A single line over 5 MB is rejected.
• Escape &, < and > inside values (&, <, >), as Meta’s sample does in its category path.
• In XML, CTX Feed writes Meta’s fields with the same g: tags as Meta’s sample (<g:id>, <g:title>, <g:link>…). Meta-only fields such as fb_product_category are written without a prefix.

Copy it to see the format. For a live store, CTX Feed builds and updates this file from WooCommerce automatically.

Facebook Marketplace bulk upload template

We couldn’t find a Marketplace bulk upload template, or a Marketplace column list, in Meta’s Business Help Center (checked October 2026). For medium to large inventories, or products that change often, Meta lists a catalog data feed as one of the routes: a spreadsheet or XML file. The CSV example above shows the layout; for a WooCommerce store, generate the feed with CTX Feed.

How to download the official template from Commerce Manager

Meta’s template is a reference for the exact column names, or a starting point for a small catalog that rarely changes.

1. Go to Commerce Manager and select your catalog.
2. Open the Catalog tab and go to Products or Data sources.
3. Click + Add in the top right and select Data file.
4. Click Download template.
5. Pick Excel (XLSX) or CSV for the standard template. For category-specific columns, click Custom template, select your product categories, then download it as .xlsx or .csv.

You need full control of the catalog to do this. Don’t rename the header row; delete the example rows and add one product per row.

A hand-filled template works for a handful of products. For a WooCommerce store, generate the file with CTX Feed instead, so price and stock changes reach Meta without anyone editing a spreadsheet.

Common Facebook feed errors and fixes

After each upload, the feed’s overview in Data sources lists the issues, and Download issue report gives you a sample. These are the errors Meta documents, with the fix on the WooCommerce side:

If a scheduled feed fails several times, Meta can pause the schedule. Resume it under the feed’s Settings → Schedules.

Products missing from the catalog altogether? See why WooCommerce products go missing from your Facebook catalog.

Facebook product feed vs Google Shopping feed

Can Meta read your Google feed? Commerce Manager has a Google Merchant Center option for files formatted for Google. A separate Meta feed still lets you use Meta’s own limits and fields, such as fb_product_category and internal_label. In CTX Feed, the Google and Facebook templates format the same products differently (see the table above).

FAQ

Wrap up

Get the nine required fields right, use Meta’s two availability values, keep sale_price lower than price, and let Meta fetch a URL instead of a file you upload by hand. CTX Feed does the formatting for Meta and keeps the file current. It’s free on WordPress.org; the Facebook catalog for WooCommerce page covers the full feature set.

Generate your Meta catalog feed from WooCommerce with CTX Feed (free on WordPress.org) → Get CTX Feed · Need 5-minute updates or Pro filters? See CTX Feed Pro

[CTA] Stop reading. Start fixing.

Fix your product feed with CTX Feed Pro.

Free version on WordPress.org. Every Pro licence includes a 30-day money-back guarantee.

See CTX Feed Pro pricing →

FS

[ABOUT] the author

Fadiyah Sameh

Fadiyah Sameh is an eCommerce researcher and writer at WebAppick. As an eCommerce writer with a strong background in SEO, she has a passion for creating compelling and informative content that helps businesses reach their target audience. In addition to her writing skills, she’s also well-versed in content marketing and the technical aspects of eCommerce and has a deep understanding of the various strategies and tactics used to optimize online stores for success.

All posts