Meta for WooCommerce

Overview

↑ Back to top

Meta for WooCommerce connects your WooCommerce store to Facebook, Instagram and WhatsApp to help people discover your ecommerce store. You can purchase advertising, find new customers, set up a shop to sell your products on Facebook, measure the results of the actions customers take on your website, and connect your WhatsApp Business account to automatically update customers about their orders.

With this extension, you can:

  • Sync your WooCommerce catalog to Facebook to let customers browse your products from your Facebook Page shop and create product-based adverts.
  • Install the Facebook Pixel to support retargeting ads, find new customers, and track ad effectiveness.
  • Engage with customers on WhatsApp by udating your customers about their orders at every step, freeing up more time for you to focus on your business.

Installation

↑ Back to top

To start using a product from WooCommerce.com, you can use the โ€œAdd to storeโ€ functionality on the order confirmation page or the My subscriptions section in your account.

  1. Navigate to My subscriptions.
  2. Find the Add to store button next to the product youโ€™re planning to install.
  3. Follow the instructions on the screen, and the product will be automatically added to your store.

Alternative options and more information at:
Managing WooCommerce.com subscriptions.

Adding a WooCommerce.com subscription to your store

Keep your Metafor WooCommerce extension up to date

↑ Back to top

The latest version number can be viewed on the Meta for WooCommerce product page under Details and compatibility. You can also navigate to Plugins > Installed Plugins in your WP Admin dashboard to check your version number and update to the latest version.

Getting started

↑ Back to top

1. Connect your Facebook and Instagram account

↑ Back to top

From your storeโ€™s WP Admin dashboard, navigate to Marketing > Facebook, click Get Started, and follow the steps below.  

This will launch the Facebook setup wizard, which will ask you to:

  1. Log in to Facebook, if youโ€™re not already logged in elsewhere.
  2. Create new Facebook assets (or choose existing ones) to connect to this store, including:
  3. Authorize the connection between WooCommerce and Facebook for your business.

Once setup is complete, you can return to your siteโ€™s WP Admin dashboard to configure other settings and features.

You can view your connected assets at any time from the Marketing > Facebook > Connection tab. To manage your connected assets and enable other features, such as setting up your Facebook Page Shop, click Manage Connection to open the Facebook Business Extension tool.

You may experience a slightly different set of screens if you do not already have a Commerce Account. However, the flow offers users the opportunity to create new assets when needed.

Your Facebook connection page should look something like this; you are now connected.

Catalog and Product Sync Guide

↑ Back to top

How to manage your WooCommerce catalog

↑ Back to top

To make your shop more discoverable and simpler to navigate, you will need to have a complete commerce catalog. The search, sort, and filter controls rely on high-quality catalog data to make it easier for buyers to consider a broad range of items and find the exact product they want. 

This guide covers how to configure your product catalog sync, set up Google Product Categories, and manage individual product settings for optimal catalog quality.

Accessing Facebook Settings

The Meta for WooCommerce settings are located at Marketing > Facebook

The settings are organized into two main tabs:

  • Shops – Connection status, shop management, sync controls, and troubleshooting
  • Attribute Mapping – Map WooCommerce attributes to Facebook catalog fields
Shops Tab

Navigate to Marketing > Facebook to access the Shops tab.

Facebook Commerce Manager

The Shops tab displays an embedded Facebook Commerce Manager interface where you can:

– View your connected Facebook assets (Page, Pixel, Catalog)

– Manage your Facebook and Instagram Shop settings

– Configure product sync preferences directly in Meta’s interface

– View sync status and catalog health

Troubleshooting Section

Click the Troubleshooting button to expand the troubleshooting drawer with manual sync controls

Sync ActionDescription
Product data syncManually sync all products from WooCommerce to your Facebook catalog
Coupon codes syncSync shipping zones and methods to Facebook
Shipping profiles syncSync shipping zones and methods to Facebook
Navigation menu syncSync your category navigation structure to Facebook
Product sync happens automatically when you create or update products. Use manual sync only if products are out of sync or some products did not sync properly.
Additional Settings

Within the troubleshooting drawer, you’ll find:

  • Enable Meta Diagnosis: When enabled, allows Meta to monitor plugin events and error logs to help fix issues.
  • Enable Debug Mode: Enables detailed logging for troubleshooting plugin issues.
    • Only enable when experiencing problems
    • Logs are stored in WooCommerce logs
  • Enable Meta-managed Coupons: This is only available when offer management is enabled and it allows Meta to create and manage coupons based on your offer setup in Meta business tools.

Google Product Categories

↑ Back to top

Google Product Category (GPC) codes are essential for:

  • Proper tax calculation on Facebook and Instagram Checkout
  • Providing category-specific attributes (material, size, color, style, etc.)
  • Better product discoverability in Shops

GPC Hierarchy (Priority Order)

  1. Product-level GPC (highest priority) – Set on individual product edit page
  2. WooCommerce Category GPC – Set on the product category

Setting Category-Level GPC

  1. Navigate to Products > Categories
  2. Click on a category to edit, or add a new category
  3. Look for the Default Google product category field
  4. Select at least two category levels (e.g., “Animals & Pet Supplies > Pet Supplies”)
  5. Save the category

Products in this category will inherit this GPC unless overridden at the product level.

Setting Product-Level GPC

  1. Navigate to Products > All Products
  2. Click Edit on the product you want to modify
  3. Scroll to the Product Data section
  4. Click the Facebook tab
  5. Find the Google product category section (in commerce fields)
  6. Select the appropriate categories
  7. Update the product

Why GPC Matters

  • Tax calculation: Products need at least two category levels defined for tax to be correctly applied
  • Attribute requirements: Certain categories require specific attributes (e.g., Apparel requires size and color)
  • Commerce eligibility: Products without valid GPC may not be eligible for checkout features

 Individual Product Settings

Each product has dedicated Facebook settings in the Product Data meta box.

Accessing Product Facebook Settings

  1. Edit any product
  2. Scroll to the Product Data meta box
  3. Click the Facebook tab

Facebook Sync Mode

A dropdown with three options:

ModeDescription
Sync and show in catalogProduct syncs to Facebook and is visible in your Shop & Catalog
Sync and hide in catalogProduct syncs but is hidden from Shop browsing & Catalog
Do not syncProduct is not synced to Facebook

Facebook Description

A rich text editor for setting a custom product description for Facebook.

  • Supports basic formatting (bold, italic, lists)
  • If left blank, the product’s WooCommerce description is used
  • Falls back to short description, then product title if no description exists
  • Maximum length: 5,000 characters

Facebook Product Image

Control which image syncs to Facebook

OptionDescription
Use WooCommerce imageUses the product’s featured image |
Use custom imageEnter a custom image URL

For custom images, enter an absolute URL (e.g., `https://domain.com/image.jpg`).

Facebook Product Video

Add video content to your product listing:

  • Select from WooCommerce media library videos
  • Or enter a custom video URL

Facebook Price

Override the product price for Facebook:

  • Enter price in monetary decimal format (e.g., `29.99`)
  • Do not include currency symbols or thousand separators
  • If blank, the WooCommerce product price is used

Product Attributes

Additional fields available for enhanced catalog data:

AttributeDescription
BrandProduct brand name
MPNManufacturer Part Number
ConditionNew, Used, or Refurbished
Age Groupnewborn, infant, toddler, kids, adult
SizeProduct size
ColorProduct color
MaterialProduct material
PatternProduct pattern 

Select two categories. Youโ€™ll then see a dropdown with more detailed attributes to complete should you wish to do so:

Select the Show advanced options checkbox and complete the following additional categories:

Catalog syncing

↑ Back to top

Once your catalog has been set up, all that remains is a full product sync. In most cases, all products will have already been synced when the extension is first connected to Facebook.

Subsequently, products will be synced any time a new product is created or an existing product is changed. In the event products are not syncing as expected, a sync can be triggered manually via the Marketing > Facebook > Product sync tab by clicking the Sync products button.

Variable products/variants

↑ Back to top

Almost there! Now youโ€™ll want to ensure all attributes for your variable products are set up to sync to Facebook correctly. Variant information is required to display the correct options to buyers during checkout. Learn more about product variants.

In WooCommerce, attributes can be defined at both the global and product levels. Global attribute definitions can be found at Products > Attributes and assigned a list of potential values, known as โ€œTerms.โ€

Once defined, these attributes can then be assigned directly to a simple product, e.g.

Global attributes can also be assigned to variable products to be used for individual variations.

Important: Every variation must have a single value for a given attribute. In the above example, the variation with ID #78 would need to be expanded into distinct products corresponding to each of the available sizes. Attempting to sync with a value of โ€œAny Sizeโ€ฆโ€ would result in an invalid Checkout product.

In addition to standard WooCommerce attributes, the extension also supports setting particular category specific variant attributes using the โ€œFacebookโ€ tab on the โ€œEdit Productโ€ page.

Note: For variable products, category specific attribute values set at the parent level will override the attributes for any child variations.

An additional inventory field is required for checkout to let buyers know when products are running low or out of stock. In order to set up your product inventory, stock management must first be enabled for WooCommerce. Confirm this setting is checked at WooCommerce > Settings > Products > Inventory.

Once this setting has been enabled, inventory counts can be set as follows:

1. From the Edit Product page for a Simple Product.

2. From the Edit Product > Inventory page for a Variable product (global).

Note: For variable products, stock quantities can be set at both the global or individual variation levels.

3. From the Edit Product > Variations page for a Variable Product (individual).

4. Lastly, from the Bulk actions > Edit > Product data section.

Facebook product data

↑ Back to top

On the Edit Product page, a new tab titled โ€œFacebookโ€ is visible. Here, you can decide whether to enable Facebook sync to your Facebook catalog or not. By default, when youโ€™re creating a new product, the Sync and show in catalog option is selected.

Please note that the Facebook Price field is used when you set a different price for the product to be shown on Facebook. The price will be different compared to the one shown on your WooCommerce store.

This is applicable only when you select Checkout with Facebook or Instagram.

As the Checkout with Facebook or Instagram option is not yet supported, we recommend that you leave the Facebook Price field empty to avoid confusion.


Note: Facebook sync setting for variable product type is available via the Variations tab.

When you have published a product and Facebook sync is enabled, the extension will automatically sync the product to your Facebook catalog. The corresponding metadata will be generated and visible on the sidebar under Facebook Product Sync.

Variation-Specific Settings

↑ Back to top

Each variation has its own Facebook settings metabox that expands when editing the variation:

  1. Edit the variable product
  2. Go to the Variations tab
  3. Expand a variation
  4. Look for the Meta for WooCommerce metabox

Variation settings include:

  • Sync mode (Sync and show / Sync and hide / Do not sync)
  • Facebook Description (plain text only for variations)
  • Facebook Product Image options:
    • Use variation image
    • Use parent image
    • Use custom image
    • Use multiple imagesย 
  • Facebook Price override

Attribute Mapping

↑ Back to top

Navigate to Marketing > Facebook > Attribute Mapping to configure how WooCommerce attributes map to Facebook catalog fields.

How Attribute Mapping Works

  1. The plugin automatically maps common attribute names (e.g., “color”, “size”, “brand”)
  2. Custom mappings allow you to map any WooCommerce attribute to a Facebook field

Creating Custom Mappings

  1. Go to Marketing > Facebook > Attribute Mapping
  2. In the mapping table, select a WooCommerce attribute
  3. Select the corresponding Facebook field to map it to
  4. Click Add new mapping to add additional mappings
  5. Click Save Changes

Supported Facebook Fields

  • Size
  • Color
  • Pattern
  • Material
  • Gender
  • Age Group
  • Brand
  • Condition
  • MPN (Manufacturer Part Number)
  • GTIN (UPC, EAN, ISBN, etc.)

Multi-Language Support

↑ Back to top

If you use a multilingual plugin (like WPML or Polylang), Meta for WooCommerce can generate language-specific product feeds.

Supported Localization Plugins

The plugin integrates with:

  • WPML
  • Polylang
  • TranslatePress

Enabling Language Override Feeds

  1. Navigate to Marketing > Facebook > Shops
  2. Expand the Troubleshooting drawer
  3. Look for the Localization section (appears only with compatible plugins)
  4. Enable Language Override Feed Generation
  5. View detected languages and their status

How It Works

– The plugin generates separate feed files for each language

– Translated content (title, description, images) syncs to Facebook

– For variable products, parent translations apply to all variations

This feature requires an eligible multilingual setup. Sites with legacy multi-language configurations may not see this option.

Facebook product validation

↑ Back to top

Besides showing the metadata (mentioned in the Facebook Product Data), the sidebar Facebook box is used to display product validation issues. Some of the settings of a product may cause it not to synchronize correctly with the Facebook catalog. The plugin is able to find some of the issues and inform the user about what the problem is.

To learn more about the types of validation performed, please check the Product validation issues section.

2. Connect your WhatsApp Business Account

↑ Back to top

From your storeโ€™s WP Admin dashboard, navigate to Marketing > WhatsApp, click Connect, and follow the onboarding steps to connect your WhatsApp Business Account.

This will launch the WhatsApp Embedded Signup flow, which will ask you to:

  1. Log in to Facebook, if youโ€™re not already logged in elsewhere.
  2. Create new Meta assets or choose existing ones to connect to this store, including:
    • Business Manager Account
    • WhatsApp Business Account
    • WhatsApp Business Phone Number
  3. Authorize the connection between WhatsApp for WooCommerce and Meta.

Once setup is complete, you can return to your siteโ€™s WP Admin dashboard Marketing > WhatsApp to complete onboarding and configure other settings and features.

WhatsApp Messaging Integration Resources:

Pricing info

Troubleshoot account restrictions

About quality rating

Official business accounts

Troubleshooting

↑ Back to top

Account quality

↑ Back to top

Some of the problems regarding your Facebook business accounts are related to insufficient account quality. Facebook checks your account to verify that it is compliant with Facebook terms and policies. If it detects issues your account may be restricted or disabled.

See if your account has advertising restrictions.

A common reason for a blocked account is two-factor authentication not being enabled.

Two-factor authentication

↑ Back to top

Facebook requires every Business Manager account older than 90 days to have two-factor authentication (2FA) enabled. This is an extra layer of security that prevents unauthorized access to your Business Manager.

See how to turn on 2FA for your Business Manager account.

A restricted account due to 2FA not being enabled.

To prevent the error shown above from occurring, we recommend setting up 2FA at the same time you set up the Meta for WooCommerce extension

Feed generation memory issues

↑ Back to top

Sometimes, if your shop has big products catalog the feed generation process may fail due to limited server memory. The error visible in the logs will look similar to this:

unexpected shutdown: PHP Fatal error Allowed memory size of 419430400 bytes exhausted (tried to allocate 20480 bytes) in /wp-includes/functions.php on line 624

This stops your siteโ€™s ability to generate the product feed required for some of the synchronization processes between your WooCommerce site and Facebook Business Manager. Even if the feed generation process would not fail it still could cause slowness of the admin interface.

In Meta for WooCommerce version 2.6.6, a new feed generation process was added. It should be free of the memory issues that the old generator was experiencing. To enable the new process please go to Facebook extension settings in Marketing > Facebook and stay on the Connection tab, then scroll to the bottom to the Debug section.

Enable the Experimental! Enable new style feed generation option. As the description points out this feature is still in the experimental phase. As soon as we confirm that it fixes the problem, we will enable it for all the users and we will remove the old feed generator.

There are no other steps required. After you enable the option and click Save changes, the next scheduled feed generation will use the new process.

The new feed generator processes the catalog in batches in the background. This allows avoiding the server memory limitation.

Sync issues

↑ Back to top
WPEngine runs a script that terminates processes taking longer than 60 seconds, which might stop the sync process. This only impacts clients on their shared hosting. A temporary workaround is to reach out to WPEngine and ask to have the script turned off for the duration of the sync.

Product validation issues

↑ Back to top

The Facebook Product Sync sidebar box is able to perform basic validation of the product. In case a problem is detected the information about the problem will be displayed in the box. For example:

Non-published products are not synchronized to the Facebook catalog. Or:

Facebook does not accept products with titles written in capital letters only.

Other possible statuses:

  • Product sync is globally disabled.
    โ€“ enable global sync setting to allow products sync
  • Product must be in stock.
    โ€“ if WooCommerce hide out of stock option is selected the product must be in stock in order to sync
  • Product is hidden from catalog and search.
    โ€“ product is set to one of the not visible settings in the product Publish > Catalog visibility section
  • Product excluded because of categories.
    โ€“ product is in one of the excluded categories
  • Product excluded because of tags.
    โ€“ product is in one of the excluded tags
  • Sync disabled in product field.
    โ€“ product is not set to sync in the product Facebook tab
  • Product description is all capital letters.
    โ€“ product description must not be capital letters only
  • Product description is too long. Maximum allowed length is 5000 characters.
    โ€“ product description is too long
  • Product title is all capital letters.
    โ€“ product description must not be capital letters only
  • Product title is too long. Maximum allowed length is 150 characters.
    โ€“ product title is too long

Other sync issues

↑ Back to top

An additional cause of a product (especially variable product) not syncing properly to the Facebook catalog is when a global product attribute is created with a name containing a disallowed character, such as :.

If we use the global attribute name that contains such disallowed character in the variable product Product data > Attributes tab when we publish or update the product, the product variations Facebook metadata are broken.

Debug tools

↑ Back to top

As of version 3.0.5, Meta for WooCommerce provides a set of tools to help with some of the most common troubleshooting tasks:

  • Facebook: Reset connection settings will clear your Facebook settings to reset them, allowing you to rebuild your connection.
  • Facebook: Delete Background Sync Jobs will clear background sync jobs (wc_facebook_background_product_sync) from the options table.
  • Facebook: Reset all products will reset Facebook metadata for all products on your WooCommerce store.
  • Facebook: Delete all products from your Facebook Catalog will delete all products from your Facebook Catalog.

To enable these tools, you will need to enable Debug mode by navigating to Facebook plugin settings in Marketing > Facebook and stay on the Connection tab, then scroll to the bottom to the Debug section.

Once youโ€™ve confirmed Debug mode is enabled, navigate to WooCommerce > Status > Tools:

Note:

  1. The tool to delete/ reset products might take some time, depending on the number of products in your catalog.
  2. The tool to delete catalog products only deletes products in the WooCommerce store due to limitations in the Meta API. Products added to the Facebook catalog by other sources or currently unlinked cannot be deleted by this tool. You might need to contact Meta support to have these deleted.

Common errors and how to resolve them

↑ Back to top

Oops, something went wrong.

↑ Back to top

While this error can occur for a few different reasons, the most common seems to be in relation to Facebookโ€™s supported currencies.

If your WooCommerce default currency is not on this list, some folks have had success temporarily changing their currency to a supported one (USD, CAD, GBP, EUR) to connect and then changing it back afterwards.

External business ID is missing

↑ Back to top

The External business ID is missing error is occasionally returned during the extension setup and disrupts the setup process. Users have confirmed resolving it by following either of these methods:

Editing the business ID in the options table

↑ Back to top

1. Go to https://example/wp-admin/options.php (Replace example.com with your domain)
2. Search for wc_facebook_external_business_id.
3. Update the field to include only supported characters and save (best practice: storename-dfsdc3lck9k6q โ† 13-digit random string. e.g, woo-dfsdc3lck9k6q)
4. Double-check the wc_facebook_external_business_id to make sure changes have been saved. If changes have not been saved, you will need to update this through the database.
5. Once changes have been saved, navigate to Marketing > Facebook, click Get Started, and attempt the setup again.

Please keep in mind that the wc_facebook_external_business_id WordPress option cannot be blank or contain non-Latin characters.

Initiating the setup on Facebook

↑ Back to top
  • Navigate to https://business.facebook.com/latest/business_app_store/
  • Select the WooCommerce Integration and click on Manage.
  • Where you see the text There are more features available to you, click on See features.
  • The Connect to WooCommerce Integration window pops up.
  • Click Continue, enter your website URL, click Connect, and complete the setup steps.

Frequently asked questions

↑ Back to top

Which Facebook policies or processes should I be aware of before setting up my store?

↑ Back to top

Products sold on Facebook must comply with Facebookโ€™s Commerce Policies. If you intend to advertise your products you must also comply with Facebookโ€™s Advertising Policies.

Uploaded products go through a review process and your product may be removed if found to be in violation of Facebookโ€™s policies. If you believe a product was incorrectly rejected, you can request a second review

Facebook also collects feedback from people who make purchases on Facebook Products, including the Audience Network and this feedback is translated into a feedback score.

When a business receives poor feedback scores on topics such as delivery speed, product quality or customer service, ads that the business runs may see reduced delivery. If the business receives a significantly high proportion of negative feedback, it may experience a temporary or permanent loss of advertising and/or access to Facebook Commerce surfaces.

Learn more about the Feedback Score.

Why should I not use the same value for categories and attributes?

↑ Back to top

WooCommerce provides a way for a user to set attributes already:

Custom product attribute of โ€œcolorโ€ with the value โ€œredโ€

If we see an attribute with the same (case insensitive) name as a category specific one (like โ€˜colorโ€™ in the example above) then, unless it is explicitly overridden in the above shown product level view, weโ€™ll send that value.

If you have two WooCommerce categories that both set a default value or google product category and they both get applied to a product, what do you do if they disagree? We find the first non-conflicting value by traversing up the tree (WooCommerce categories are also hierarchal). If you do not find a non-conflicting version we assume thereโ€™s no valid default. 

How can I tell if the Facebook Pixel has been properly installed on my site?

↑ Back to top

The Pixel Helper is a small Chrome extension provided by Facebook which will allow you to verify that your pixel has been properly installed and works as expected. Learn more about the extension and download it.

How can I set up the Facebook Conversions API?

↑ Back to top

The Conversions API creates a direct connection between marketing data such as website events and conversions from your server to Meta. This marketing data helps power ad personalisation, optimisation and measurement on Meta so that your ads are shown to people who are more likely to find them relevant.

The Facebook conversion API is integrated out of the box in the Meta for WooCommerce extension. This means that once you set up the extension, the conversion API is automatically implemented and no additional setting is required from you. The data that flows through Conversions API and the Facebook Pixel is deduplicated based on a unique event ID, so thereโ€™s no concern about the same events being counted twice.

Help! Iโ€™ve been locked out of my Facebook account. What should I do?

↑ Back to top

Weโ€™re so sorry about that! This should now be a rare occurrence, but can occur if you create a Facebook account immediately before setting up business accounts, pages, and other assets. You can fill out this form so the Facebook team can begin recovering your account.

Why are my products not displayed on my shop after installing the plugin?

↑ Back to top

If none of the products have synced to Facebook, the most likely reason for this issue is due to the Facebook shop having been set up outside of our pluginโ€™s wizard causing your Facebook page to link to a Facebook catalog other than the one our extension uses. Learn more about this configuration issue and how to solve it.

If only some of your products are missing from your Facebook shop, then this may be due to some of your products being out of stock, virtual products, or there being too many variations.

My pixel is missing or not available. How can I see all the pixelโ€™s through the extension setup window?

↑ Back to top

As of version 2.0 of the extension, only pixels created through the business manager can be selected through the plugin setup window. Personal ad pixels will not be available.

Versions prior to 2.0 were the opposite: oly personal ad pixels were available, and business manager pixels were not.

Customers are being sent directly to checkout when choosing to purchase a product. How can I send them to the product page instead?

↑ Back to top

By default, the link that is shared with Facebook is an โ€œAdd to Cartโ€ URL for your product to speed up the checkout process.

You may want this to be the product URL for a number of reasons. If so, you can use this code snippet to send the product URL to Facebook instead:

<?php // only copy this line if needed
/*
* Change checkout URLs to product URLs for Facebook products
*/
function sv_fbw_checkout_url_to_product( $product_data, $id ){
$product_data['checkout_url'] = $product_data['url'];
return $product_data;
}
add_filter( 'facebook_for_woocommerce_integration_prepare_product', 'sv_fbw_checkout_url_to_product', 100, 2 );

view raw

How do I re-connect the plugin to my shopโ€™s Facebook page?

↑ Back to top

A frequent troubleshooting step when encountering issues with product sync or the connection, in general, will be to re-connect the plugin to Facebook. Learn More

Facebook shows โ€œSorry, this content is not available right nowโ€. How can I re-configure the plugin?

↑ Back to top

If you lose access to the account that configured the plugin, or Facebook invalidates the account or merchant settings configuration, this message will be displayed.

In this case, you may need to reconnect your extension.

How can I get Facebook to display prices including tax?

↑ Back to top

The price synced to your Facebook catalog should include tax if your WooCommerce shop is set to display prices including tax. You can find this option available at WooCommerce > Settings > Tax and select โ€œIncluding taxโ€ from the Display prices in the shop drop-down option.

That said, there are other tax options at play here. For instance, if you have the store set to โ€œEntered prices exclude taxโ€ yet the Display options are both set to โ€œIncluding taxโ€, WooCommerce will need to generate tax on the product price before sending this across to Facebook. If the tax option is set to generate taxes from the โ€œCustomerโ€™s addressโ€ then this might not work, as the Facebook sync has no specific customer address.

In this case, youโ€™ll need to work out the best workaround:

  • Setting the โ€œcalculate tax based onโ€ to the shop address
  • Enter prices inclusive of tax

Some events are not triggering with caching plugins (Breeze, SG Optimizer, Asset CleanUp, etc). How can I fix this?

↑ Back to top

Some caching plugins have some optimization settings that cause a conflict with the pixel tracking code that will result in the event not being triggered. This can be tested with the Meta Pixel Helper Chrome extension and seeing that the ViewContent (as an example) is not triggered on the view product page.

The fix is to disable grouping of JS.

Is it possible for me to bulk-delete or reset all of the products in my store that are synced to Facebook?

↑ Back to top

Occasionally, deleting or resetting all products from the Facebook catalog and then letting things sync again is the only way to fix strange issues. This requires a code snippet.

How do I remove the extension, WooCommerce Facebook app, and created system users?

↑ Back to top

Clicking the โ€œUninstallโ€ link in your settings will not remove the app from Facebook and any associated system users. Learn how to remove these.

How do I disable the Facebook Pixel generated by Meta for WooCommerce?

↑ Back to top

You can use the following code snippet to disable the extensionโ€™s Facebook Pixel and Conversion API (CAPI):

add_filter( 'facebook_for_woocommerce_integration_pixel_enabled', '__return_false' );

Can I use Instagram Shopping with Meta for WooCommerce?

↑ Back to top

At the moment Instagram shopping support is not available. You can use Instagram Shopping extension if you need users to check out from Instagram.

With this extension, merchants can link an Instagram Business Account to the Facebook account and then sync the products to the Facebook catalog. This catalog can be shared between Facebook and Instagram.

Is checkout on Facebook and/or Instagram supported?

↑ Back to top

Checkout with Facebook and/or Instagram is not yet supported. We highly recommend not selecting the Facebook/Instagram checkout option when creating a Faceook/Instagram shop or commerce account associated with the Faceook for WooCommerce extension catalog.

As this feature is not supported, you may not be able to fulfil customersโ€™ orders if you attempt to use the extensionโ€™s catalog for Facebook/Instagram checkout.

How do I enable logs with headers?

↑ Back to top

The extensionโ€™s logging system no longer prints log headers to allow for simpler log analysis. If for any reason the content of the logs headers is required, this can be enabled by setting the wc_facebook_request_headers_in_debug_log option to true. Once this is no longer, needed please remove the option to restore the minified logs.

Is Meta for WooCommerce compatible with Product Bundles/Composite Products?

↑ Back to top

Meta for WooCommerce is compatible with the Product Bundles and Composite Products extensions; products created via these extensions can be synced to your Catalog.

While earlier versions of Meta for WooCommerce did not support syncing โ€œUnassembledโ€ bundles, newer versions from v2.6.28 support syncing Product Bundles in Assembled and Unassembled shipping modes.

Is it possible to unlink a Facebook page linked to a Commerce account created through Meta for WooCommerce?

↑ Back to top

When you install and connect your Facebook account through Meta for WooCommerce, a Commerce account is created and linked to the Facebook page selected during the connection onboarding process.

To unlink a Facebook page linked to a Commerce account, you need to unlink it first from the catalog used within the Commerce account:

  • Go to your Business Settings on Facebook, and choose the Business Manager previously selected for the Meta for WooCommerce.
  • Under Data Sources, click on the catalog that was selected before during the pluginโ€™s connection onboarding process, and click Remove to remove it, this will delete the catalog contents (please be aware of this). The page will no longer be associated with this catalog.
  • Under Accounts, select the page you want to remove from your Business Manager, then click Remove.

Why arenโ€™t my product pages built with Divi Builder syncing to my Facebook catalog?

↑ Back to top

The Divi theme and page builder formats your content using custom shortcodes. The Meta for WooCommerce extension removes all known shortcodes from product descriptions when syncing your catalog. However, in some cases, the Divi Builder does not register its shortcodes with WordPress in time for them to be visible to our Facebook extension for cleaning before synchronization. This can lead to very large product descriptions and errors like โ€œthe description is too long (over 5000 characters)โ€.

There are several workarounds for this issue:

  • In Marketing > Facebook > Product sync, set the Product description sync setting to โ€œShort descriptionโ€, which will tell Meta for WooCommerce to always use your productsโ€™ Product short description when syncing your catalog.

  • Use the Facebook Description on the product editor > Product data > Facebook to specify a custom Facebook description (or product editor > Product data > Variations > [variation] for Variable products).

  • Disable the Divi Builder and return to the Standard Editor. Be sure to copy and save any product description copy you would like to keep, as it will be permanently deleted after making the switch.

How to get the Facebook Product Feed URL

↑ Back to top
  1. Navigate to the Facebook settings page under Marketing > Facebook /wp-admin/admin.php?page=wc-facebook&tab=connection
  2. View the page source to see the feed script.
  3. Copy the URL from the feedUrl: object.

Questions

↑ Back to top

Do you still have questions and need assistance? 

Related Products

Offer add-ons like gift wrapping, special messages or other special options for your products.

Add shipment tracking information to your orders.