WooCommerce Instagram shop: how to set it up and fix a sync that fails

To get a WooCommerce Instagram shop today, install Meta’s Meta for WooCommerce plugin (it used to be called Facebook for WooCommerce), connect your Business Manager, Facebook Page and catalog, let it sync your products, then get your Instagram account approved for Shopping. Shoppers tap a product tag and pay on your own WooCommerce checkout.

Checked on November 4, 2026, against WooCommerce’s guide to the plugin and Meta’s developer documentation, all linked below and listed under the article.

What changed, and what’s possible now

Two things make most guides on this topic out of date.

The plugin moved. The old Facebook for WooCommerce listing on WooCommerce.com now says “We retired this product”, and its setup guide says it “will no longer be updated.” The plugin lives on as Meta for WooCommerce, by Facebook, in the WordPress.org plugin directory: version 3.7.8 (released Oct 5, 2026, per its changelog), with 400,000+ active installs when we checked. Meta’s GitHub page puts it plainly: “Meta for WooCommerce, formerly Facebook for WooCommerce, is now an official plugin from Meta.”

Checkout happens on your site. Meta’s Commerce Platform docs say buyers “complete checkout on your website.” Its Shops ads page adds that a shop can switch from onsite checkout to offsite checkout, “but not the other way around.”

Requirements checklist

Go through this list before you install anything. Each line comes from the page linked in it.

• WordPress 5.6 or higher and PHP 7.4 or higher, the minimums on the plugin’s directory page.
• A WooCommerce store that’s live on your own domain. Meta’s catalog reference says product links must be “hosted on your business’s website domain.”
• Admin access to your Facebook Page and to the business that owns it. Meta’s Page eligibility docs give both as reasons a Page “cannot be used.”
• A Business Manager account with two-factor authentication. The WooCommerce guide notes that “Facebook requires every Business Manager account older than 90 days to have two-factor authentication (2FA) enabled.”
• An Instagram professional account connected to that Facebook Page. Meta’s Instagram Platform overview says that with a Facebook login, like this plugin’s setup, the professional account “must be connected to a Facebook Page.” Business and creator accounts both count as professional, but Meta’s product tagging docs say “Product tagging is not supported for Instagram Creator accounts.” A Business account is the safer pick.
• Stock management turned on, at WooCommerce > Settings > Products > Inventory. Meta’s Quantity to Sell page says “An item without quantity to sell setup cannot be tagged or purchased.”
• Products with the basics filled in: title, description, price, main image and brand. The full list of field rules is in the sync checks below.
• A business in a region where Meta offers Shops. “Facebook Shops are currently not available in your region” is one of the messages in Meta’s Page eligibility docs.

How to set it up with Meta for WooCommerce

These steps follow the WooCommerce guide, last updated May 1, 2026. Since that guide is no longer updated, a newer version of the plugin may label a screen differently.

1. Install the plugin. In WordPress, go to Plugins > Add New, search for Meta for WooCommerce, click Install Now, then Activate (the standard steps from WordPress.org). Check that the author is Facebook.
2. Start the setup. Go to Marketing > Facebook and click Get Started. The wizard asks you to log in to Facebook.
3. Choose or create your assets. The wizard covers a Business Manager account, a Facebook Page, an ad account, a Meta Pixel, catalogs and 2FA setup. Pick the ones you already use, so your products land in the catalog your Instagram account will tag from.
4. Authorize the connection. You can see it later under Marketing > Facebook > Connection. Manage Connection opens the Facebook Business Extension tool, where you manage your assets and features like the Facebook Page Shop.
5. Let the products sync. In the guide’s words, “Product sync happens automatically when you create or update products.” Each product has a sync setting: Sync and show in catalog (the default for new products), Sync and hide in catalog or Do not sync. The Shops tab shows an embedded Commerce Manager, with sync status and catalog health. The Attribute Mapping tab matches your WooCommerce attributes (size, color, brand and others) to Meta’s fields.
6. Wait for two reviews. Meta reviews the shop: its troubleshooting docs say the review “can take up to 28 days” and that shops “will not be visible to public” until approved. Separately, your Instagram account “must be approved for the Shopping functionality.” Without that, your products can’t be tagged.

The other route: a product feed

Some stores skip the plugin and give Meta a feed file instead: a feed plugin publishes your products at a URL, and Commerce Manager fetches it on a schedule. Meta’s scheduled feeds page says they “don’t support uploads more frequently than once per hour,” so a price change or a sellout can reach Instagram later than with the plugin, which syncs when you update a product. It can make sense if you already keep a product feed for other channels. The field rules below apply either way.

Checkout: where your customers pay

Plan on checkout happening on your WooCommerce site. Three official pages agree:

• Meta’s Commerce Platform docs: buyers “discover products on Facebook and Instagram and complete checkout on your website.”
• Meta’s checkout URL guide describes the cart from a shop being passed to your site, where shoppers buy on “your website checkout.”
• The WooCommerce guide: “the Checkout with Facebook or Instagram option is not yet supported.”

You may still see in-app checkout mentioned in Meta’s docs. The catalog reference keeps a group of fields headed “Additional Required Fields for Checkout on Facebook and Instagram (US Only),” and the Page eligibility docs keep a message for regions where “Checkout on Facebook or Instagram is currently not available.” For a US WooCommerce store, that doesn’t change anything: the plugin doesn’t support in-app checkout, so the order and the payment stay in WooCommerce.

Sync not working? Check these in order

Start at the top and stop when you find the cause. The first checks take seconds; the last ones take a review.

1. The connection dropped

Check: Marketing > Facebook > Connection. Are your Page, catalog and Business Manager still listed? Fix: Click Manage Connection and reconnect. If Meta restricted your business account, the WooCommerce guide points to account quality, and names missing two-factor authentication as a common cause.

2. The product is set not to sync

Check: Open the product and look at its Facebook sync setting. Fix: Set it to Sync and show in catalog. “Sync and hide in catalog” sends it to Meta but hides it; “Do not sync” keeps it out.

3. The product fails validation

Check: On the product’s edit screen, the Facebook box in the sidebar lists its validation issues. Fix: Fill in what Meta requires. From Meta’s catalog reference:

The plugin’s own Facebook Description field takes up to 5,000 characters. Left empty, it uses your WooCommerce description, then the short description, then the product title.

4. A variation says “Any”

Check: In a variable product’s Variations tab, look for a value like “Any Size” or “Any Color.” Fix: Give each variation one value per attribute. The WooCommerce guide: “Every variation must have a single value for a given attribute.”

5. Stock isn’t tracked

Check: WooCommerce > Settings > Products > Inventory, then the stock quantity on the product or variation. Fix: Turn on stock management and enter real quantities. Without a quantity to sell, Meta says an item can’t be tagged or bought.

6. The category is too vague

Check: The Google product category, set per category (the Default Google product category field under Products > Categories) or per product (the Facebook tab in Product data). Fix: Choose at least two levels. Some categories need extra attributes: the WooCommerce guide’s example is “Apparel requires size and color,” and Meta’s catalog reference requires size for clothing and shoes.

7. Products drift out of sync

Check: Compare a product’s price and stock in WooCommerce with the same item in your catalog, through the Commerce Manager view on the Shops tab. Fix: Open the Troubleshooting drawer on the Shops tab and run Product data sync, which will “Manually sync all products from WooCommerce to your Facebook catalog.” Still wrong? Turn on Enable Debug Mode, sync again and read the WooCommerce logs. Turn debug mode off once you’re done.

8. Products are in the catalog but not on Instagram

Check: Two approvals: the shop, and your Instagram account for Shopping. Fix: Give the shop review its time (up to 28 days, per Meta). If Instagram isn’t approved, check that the account you connected is the professional account linked to the right Facebook Page.

9. A product was rejected

Check: Catalog health in Commerce Manager. Meta’s tagging docs say “tags of rejected products will not appear on published posts.” Fix: Correct the product data if that’s the problem. Meta’s tagging docs mention a Product Appeal endpoint for developers; in practice, fix the data and let the product be reviewed again.

10. Meta won’t let you create the shop

Check: The exact message. Meta’s Page eligibility docs list these: you’re not a Page admin; you’re not an admin of the business that owns the Page; the Page already has a Shop; Shops aren’t available in your region; checkout on Facebook or Instagram isn’t available in your region. Fix: Get admin access on both the Page and the business, or connect the Page that already has a shop instead of starting a new one.

Tagging products once you’re approved

Meta’s developer docs for tagging through the API allow up to 20 tags on a photo or video feed post, 20 per carousel with no more than 5 on each slide, and 30 on a Reel. Stories can’t carry product tags. Limits in the Instagram app itself may differ, so check the tagging screen in your own account. Only products with an approved review status can appear as tags.

The same page keeps a note from 2023: from Aug 10, 2023, “some businesses without checkout-enabled Shops will no longer be able to tag their products” through the API, and tags on their older posts would be removed. Rules like this differ by market, so check that the tagging option shows up in your own account before you plan a month of posts around it.

A tag doesn’t replace a good caption. Name the product the way your store names it, so people can find it even without tapping. Our list of Instagram captions for products has 70 to start from, and the free product caption generator drafts five from one product.

Then give the shop something to show

An approved shop with a quiet feed sells nothing. Tags only work on posts that exist, and people judge your store by your grid before they tap anything.

• Need ideas? The post ideas for online stores cover drops, restocks, gift guides and the making.
• Check how your next posts sit together with the free grid preview, and run through the 15-minute grid fix, 12 quick fixes for a store’s grid.
• Selling on Shopify too? The Instagram for Shopify stores guide covers the same setup on Shopify’s side.

If posting is the part that stalls, Season reads WooCommerce stores to make Instagram posts. It doesn’t set up Instagram Shopping or add product tags, so the steps above stay yours. Get early access.