How to Connect WooCommerce to Facebook

Three ways to connect WooCommerce to Facebook

1. An official plugin or module

The free, official Meta for WooCommerce extension (formerly Facebook for WooCommerce) connects your store to a Facebook catalog and installs the Meta Pixel. It's built for Facebook and Instagram only, and it adds another plugin to your WordPress site.

2. Export a file yourself

WooCommerce's built-in product export (Products > Export) gives you a CSV of your WooCommerce catalog, but its columns are WooCommerce's own - "Regular price", "In stock?", "Images" - not the field names and formats Facebook expects. You'd have to rename and reformat it, and redo that every time something changes. If you go this way, start from our free Facebook Catalog CSV Template Generator so at least the columns are right.

3. A store catalog connector

A connector reads your WooCommerce catalog through WooCommerce's REST API and builds the Facebook feed for you. Because WooCommerce can send webhooks, a good connector updates in real time - a price change or a sold-out item reaches your feed within moments, not at the next export. The connector hosts the feed at a URL that Facebook reads on a schedule, and one connection can usually feed several platforms at once.

What Facebook needs

• A Meta business portfolio with access to Commerce Manager, where your catalog lives.
• Nine fields per product: id, title, description, availability (in stock or out of stock), condition, price, link, image_link, and brand.
• Images in JPEG or PNG, at least 500 x 500 pixels and up to 8 MB.
• A data feed - a file you upload, or a URL that Commerce Manager fetches hourly, daily, or weekly.

How your WooCommerce fields map to Facebook

The table above shows where each Facebook field comes from in your WooCommerce catalog. A few WooCommerce details need extra care:

• Variable products: each variation (Navy / M, Navy / L...) should become its own listing with its own price, stock, and image, all sharing the parent product as their item_group_id. Put sizes and colors in attributes named Size and Color so they can be read reliably.
• Brand: WooCommerce has a built-in Brands feature in recent versions. If you don't use it, your feed needs a default brand - usually your own store's name if you make the products.
• GTIN: recent WooCommerce versions include a "GTIN, UPC, EAN, or ISBN" field on the Inventory tab. Fill it in for products that have barcodes.
• Descriptions are stored as HTML in WooCommerce, so they have to be converted to plain text for the feed.

Step by step

1. Get your Facebook account ready - see "What Facebook needs" above.
2. Give read access to your store. WooCommerce has a built-in approval screen for apps, or you can create a key yourself under WooCommerce > Settings > Advanced > REST API with Read permission. Read-only is all a catalog feed needs.
3. Map your product types to Google product categories. Facebook needs to know what each product is. Map each value of your product attribute (like "Type") to one category from the Google product category list once, and every product with that value is categorized from then on.
4. Add the data feed in Commerce Manager. Open your catalog, go to Data sources, add items with a data feed, choose a URL, and paste your feed URL with its login. Pick a daily schedule.
5. Check the first import. Review the errors Facebook reports and fix them in WooCommerce, not in the feed - your store stays the single source of truth.

Common WooCommerce to Facebook problems

• Grouped and external/affiliate products. A grouped product has no single price, and an external product links to someone else's site, so neither belongs in your WooCommerce catalog feed. Simple and variable products are the ones to sync.
• Draft, private, or hidden products. Only published products with a public product page can be listed - the link has to open for a shopper.
• Items rejected for a missing brand. Facebook requires brand on every item - set a default if your store doesn't record one.
• Backorders. Facebook has no "preorder" value, so backordered items need to be sent as in stock or out of stock. Facebook Catalog Feed Errors, Fixed covers the rest.

Related guides

For more on Facebook itself, see How to Create a Facebook Catalog Without Shopify. Running a Presta catalog instead of a WooCommerce catalog? PrestaShop to Facebook covers the same setup for PrestaShop.