19 "note": "Meta for WooCommerce's catalog-sync outcome (products visible in a Facebook/Instagram/WhatsApp catalog) has a native Wix equivalent; the plugin's own per-product settings (fb_visibility, _wc_facebook_google_product_category, etc.) do not carry over — see pitfalls."
20 }
21 ],
22 "dependsOn": ["stores/product"],
23 "preferredWrite": {
24 "surface": "Manual -- no API; merchant connects via Wix dashboard + Meta Commerce Manager",
25 "endpoint": null,
26 "writerId": null,
27 "verification": "none",
28 "importSafe": null,
29 "bulk": false
30 },
31 "reliability": {
32 "status": "reliable",
33 "flags": []
34 },
35 "pitfalls": [
36 {
37 "code": "per-product-settings-not-portable",
38 "severity": "warning",
39 "summary": "The connect flow below reproduces the sync OUTCOME, not the plugin's per-product configuration. Meta for WooCommerce's fb_visibility, _wc_facebook_product_image_source, _wc_facebook_google_product_category, _wc_facebook_gender, and _wc_facebook_color_attribute have no receiving field: wix.stores_channels.marketplace_overrides.v1.product_override (the live, GA per-product channel-override mechanism) implements only googleProductOverrides/youtubeProductOverrides in its oneof — no facebookProductOverrides variant exists (verified via docs-schema MCP fqdn_schema, 2026-08-16). Report these as accepted, reported loss."
40 }
41 ],
42 "mappingGuidance": [
43 "Dependencies: stores/product must be migrated before the merchant connects Meta, so the generated catalog contains products to publish.",
44 "Tell the merchant to follow manualSteps below to reconnect the catalog fresh in Wix; do not attempt to carry over the plugin's stored per-product Meta settings, which have nowhere to write to."
53 "path": "wix.stores_channels.feed.v1.catalog (BuildMarketplaceCatalogFeedUrlV2 / GetMarketplaceCatalogFeedV2 — Get Catalog Link) and wix.stores_channels.facebook_feed.v1.facebook_checkout_router (GenerateFacebookCheckoutUrl / FacebookCheckoutRoute — Get Checkout URL), both GA — verified via docs-schema MCP, 2026-08-16"
54 },
55 {
56 "type": "internal-fqdn",
57 "path": "wix.stores_channels.marketplace_overrides.v1.product_override — the per-product override oneof (MarketplaceSpecificOverrides) implements googleProductOverrides/youtubeProductOverrides only, confirming no per-product Facebook override surface exists"
58 }
59 ],
60 "manualSteps": {
61 "prerequisite": "A catalog created in Meta Commerce Manager (external, Meta-side setup — Wix does not create it).",
62 "steps": [
63 { "actor": "merchant", "text": "In the Wix dashboard, go to Catalog > Sales Channels > Meta Catalog, click Get Catalog Link, and copy the generated feed URL." },
64 { "actor": "external", "text": "In Meta Commerce Manager, add the copied URL as the catalog's data feed." },
65 { "actor": "merchant", "text": "Back in the Wix dashboard, click Get Checkout URL under Meta Catalog and copy it." },
66 { "actor": "external", "text": "In Meta Commerce Manager, set that URL as the catalog's checkout URL so shoppers who buy from Meta are routed to Wix checkout." }
67 ],
68 "mechanism": "Pull-based: Meta polls the Wix-hosted feed URL on its own schedule, so any product change in Wix republishes automatically on the next pull — there is no push/webhook from Wix. Digital products are excluded from the feed. Native Facebook/Instagram Shops checkout inside the Wix dashboard was discontinued by Meta in April 2024; this feed+checkout-redirect flow is the current mechanism.",