Before You Start #
Make sure you have the following:
-
A Facebook Business Manager account
-
At least one Facebook Product Catalog
-
Admin access to your WordPress and WooCommerce site
-
The WooCommerce Facebook Catalog Sync plugin installed and activated
If you haven’t installed the plugin yet, see the Installation guide first.
Step 1: Create a Facebook App #
To enable product synchronisation, you must first connect your WooCommerce store to Facebook using a Facebook App and OAuth authentication. This process is secure and only requires a few minutes to complete.
-
Go to Facebook Developers
-
Click Create App
-
Choose Business as the app type
-
Complete the app creation process
-
From the App Dashboard, copy:
-
App ID
-
App Secret
-
⚠️ Keep your App Secret private. Never share it publicly.
Step 2: Grant Catalog Permissions #
Inside your Facebook App:
-
Open App Review → Permissions and Features
-
Enable Catalog Management
-
Ensure the app has access to your Business Manager and Product Catalog
This permission allows the plugin to read and update catalog products on your behalf.
Step 3: Connect from WooCommerce #
-
In WordPress Admin, go to
WooCommerce → Facebook Sync -
Enter your:
-
Facebook App ID
-
Facebook App Secret
-
-
Click Connect to Facebook
You will be redirected to Facebook to authorise the connection.
Step 4: Authorize the App #
-
Log in to Facebook (if prompted)
-
Select the correct Business Manager
-
Choose the Product Catalog you want to sync
-
Approve the requested permissions
Once approved, you’ll be redirected back to your WooCommerce dashboard.
Step 5: Confirm Connection #
After a successful connection, you will see:
-
✅ Connection status: Connected
-
✅ Selected Facebook Product Catalog
-
✅ Initial product scan starting automatically
At this point, your store is fully connected and ready to sync products.
What Happens Next? #
After connecting:
-
The plugin performs an initial scan of your WooCommerce products
-
Existing Facebook products are intelligently matched
-
Sync candidates appear under:
-
Push Candidates
-
Pull Candidates
-
Synced Products
-
No products are synced automatically without your confirmation.
Disconnecting from Facebook #
You can disconnect at any time:
-
Go to WooCommerce → Facebook Sync
-
Click Disconnect
Disconnecting will:
-
Revoke Facebook access
-
Stop all syncing
-
Retain local product data
-
Allow reconnection later with intelligent rematching
Troubleshooting #
“Access token not found” #
-
Disconnect and reconnect to refresh authentication
“No catalogs available” #
-
Ensure a Product Catalog exists in Facebook Business Manager
-
Confirm your app has Catalog Management permission
Connection fails immediately #
-
Double-check App ID and App Secret
-
Ensure the app is not in restricted or development-only mode
Security Notes #
-
Authentication uses Facebook OAuth 2.0
-
No Facebook passwords are stored
-
Access is limited to WordPress admins only
-
Tokens can be revoked at any time
You’re now ready to start syncing products between WooCommerce and Facebook.
