Get started

Meta Commerce

The Meta Commerce integration covers Instagram Shop and Facebook Shop. Both surfaces read from a single Meta Commerce Catalog, so connecting one connects both.

Connecting

  1. Create a Facebook Business Page and link it to your Instagram Business account (Meta Business Manager → Accounts).
  2. In Meta Business Manager, create a Commerce Catalog of type E-commerce and copy the catalog id.
  3. In Mercentia, open Channels → Meta Commerce and click Connect with Meta. Approve the catalog_management + business_management scopes.
  4. Paste the catalog id and (optional) Instagram Business Account id. Mercentia stores a long-lived page access token and refreshes it automatically.

Catalog upgrade

Mercentia publishes products in the 2026 Catalog API shape (/v22.0/{catalog-id}/products), which adds:

  • Multi-currency additional_price rows so a single product is shoppable in every market you sell to.
  • condition, brand, and mpn for “Shop” surface ranking.
  • variant_attributes for size / colour groupings inside Instagram Shop product detail pages.

Each Mercentia variant is published as its own retailer-id ({productSlug}__{variantSku}). Image sets follow the product’s image gallery order.

Sync model

  • Initial publish: triggered from the product page → Channels panel → toggle Meta Commerce. A full batch upload runs immediately.
  • Incremental sync: every product mutation (price, stock, image) enqueues a single-item update batch.
  • Reconciliation: nightly job diffs the local catalog fingerprint against the remote catalog and re-publishes drifted items.

Tagging posts and reels

Once products are in the catalog, your team can tag them in Instagram posts and Reels through the standard Instagram app. Approval state per product is exposed at Channels → Meta Commerce → Items; rejected items show the Meta reason (e.g. “missing brand”, “broken image url”) so you can fix and re-submit.

Disconnect

Channels → Meta Commerce → Disconnect un-links the catalog from Mercentia but leaves the catalog itself intact on Meta — so existing tagged posts continue to function.