Shopify Marketplace Connect inventory sync not working: the 5-rung diagnostic

Shopify Marketplace Connect — the app formerly known as Codisto — is the first-party bridge between a Shopify store and Amazon, eBay, Walmart (US), and Target Plus (US), syncing orders, listings, and inventory (Shopify Help Center, accessed October 2026). Its current state, as of October 2026, includes one closed door: new Etsy connections can't be made — "New connections to Etsy can't be made at this time" per the Help Center — while existing Etsy connections continue to work.

When its inventory sync misbehaves, the cause is almost always one of five things, and the most common isn't the app being down at all — it's location mapping. Work the ladder top to bottom; each rung either finds the problem or clears a suspect.

What it is, what it costs, and what it doesn't promise

The facts worth having in one place (Shopify App Store listing, as of October 31, 2026, and Shopify Help Center):

• 4.1 stars across 2,134 reviews; free to install.
• The first 50 marketplace-synced orders per month are free; after that, 1% per synced order, capped at $99/month.
• Inventory location is configurable per product, in bulk, or per regional marketplace — not per variant (Shopify Help Center). That restriction drives the most common failure in this article.

One more fact that prevents bad planning: Shopify describes sync speed only as "real-time" — marketing language with no published latency figures anywhere in the documentation. Don't build a process around a number the vendor never published; build it around the assumption that a window always exists between a sale and the marketplace's number moving.

Where the app sits in the wider picture — whether a marketplace channel is worth the overhead at your volume — is covered in the multichannel inventory guide.

What reviewers report (merchant-reported, not documented defects)

App Store reviews dated September 2026 describe three recurring failure shapes: eBay integration breakage with re-syncs failing repeatedly, listings repriced to zero, and image uploads stalling mid-sync. Frame these the way the evidence does — reviewers report them; Shopify has not documented them as defects.

The takeaway isn't "the app is broken." It's that certain failure modes recur often enough in merchant reports that your diagnostic should check for them by name: a channel that suddenly can't re-sync, a price field that went to zero, a listing that stalled halfway through an update.

The five-rung diagnostic ladder

Rung 1: Channel and connection status

Confirm each marketplace shows connected and authorized inside the app. Expired authorizations, channels left paused after a settings change, and partial disconnects all present downstream as "inventory stopped syncing" — when the sync was never asked to do anything because the pipe was closed. Reconnect the channel and force a small test push before moving on.

Rung 2: The sync queue

Bulk edits and peak order volume flood the queue. A backlog looks identical to a stoppage from the storefront side: numbers that haven't moved in an hour. Check the queue depth and let it drain before concluding anything is broken. If it drains and quantities are still wrong afterward, the problem lives on a lower rung.

Rung 3: Product and variant mapping

A marketplace listing only tracks the Shopify product it's mapped to. Unmapped products don't push — silently. Two classic holes: listings created directly in Seller Central or Seller Hub that were never linked back, and products added to Shopify after the connection was set up. A listing with no mapping shows whatever quantity it was created with, indefinitely, while its Shopify twin sells without it.

Rung 4: Inventory location mapping — the most common miss

Marketplace Connect pushes quantities from the Shopify locations you designate for each marketplace, configured per product, in bulk, or per regional marketplace — and never per variant. Three consequences:

• Stock in the wrong location reads as zero. If inventory sits in a location that isn't selected for that product's marketplace, the channel sees zero or a stale number while Shopify shows the truth. "Shopify says 40, Amazon says 0" is this rung until proven otherwise.
• Location changes don't always survive. Adding, merging, or renaming a Shopify location can silently change what feeds a channel. Re-check assignments after any location edit — the cheapest audit in the whole ladder.
• Variants can't split. Because location selection is per product rather than per variant, a product whose variants live in different locations (sizes on the retail floor, overflow in the warehouse) can't express that split to a marketplace. The setting picks one pool per product; consolidate the stock or accept the limitation knowingly.

When reading numbers at this rung, remember what Shopify counts as sellable: available versus committed or reserved units differ, and a channel that just sold a unit shows one fewer than your admin's on-hand figure until the next push.

Rung 5: Rate limits and the pricing tier

Two throttles live here. First, marketplace API rate limits: during peaks, a channel can accept updates slower than you're generating them, and the queue backs up — which is why rung 2 comes first. Second, the app's own order-volume tier: the first 50 marketplace-synced orders a month are free, then 1% per synced order capped at $99/month, as of October 31, 2026. A tier surprise isn't a sync failure, but merchants who discover the percentage mid-peak sometimes pause the app, which then looks exactly like one.

The qty-1 trap (community-reported)

A report circulating in r/shopify in October 2026: one-of-a-kind listings staying live on a marketplace after the unit sold. Label this what it is — community-reported, not a documented defect — but treat it as a real risk, because the failure shape is precisely what sync lags produce: a sale on one side, a number that hasn't moved on the other, and a listing that says "available" when it isn't.

The safe fix costs nothing. For any SKU where quantity is always 1 — an artist-series enamel pin, a one-off sample, a single vintage find — either end the listing manually the moment it sells, or exclude one-of-a-kind SKUs from sync entirely and manage them by hand. The lag that's tolerable on a 200-unit SKU is intolerable on a unit you can't replace.

Prevention: three settings habits

• Location mapping discipline. Keep a written record of which locations feed which marketplace, and re-verify after every location change. This is the rung-4 miss, prevented on paper.
• Watch the first sync after any bulk edit. Bulk edits can touch status, location, and category fields in ways that only surface at the next push. Monitor the first sync rather than assuming it went clean; the inventory states guide explains what each field means to availability.
• A weekly channel audit. Spot-check ten SKUs across your channels against Shopify — same day, every week. It's the audit habit from when Shopify inventory stops updating, extended to channels.

When to escalate

After rung 5, you've exhausted what self-service diagnosis can see. Two doors:

1. Shopify support. Marketplace Connect is a Shopify-first-party app, so a Shopify support ticket is the correct front door. Include the channel, the SKU, timestamps, listing IDs, and expected versus pushed quantities. Evidence, not narrative.
2. The app's own logs. The sync history inside the app records what was pushed and when. A screenshot of a failed or stalled entry shortens every support conversation that follows.

The honest close: a mismatch caught in the weekly audit is a corrected field. The same mismatch caught by a customer is an oversell apology — a refund, an email, sometimes a marketplace feedback score you don't get back. The distance between those outcomes is the oversell window, and the audit habit is what shrinks it.

One boundary so this walkthrough can't be mistaken for a pitch: InventoryX doesn't sync anywhere — it's a read-only planning layer for a single store — so marketplace syncing sits entirely outside it, and the ladder above is what we'd run regardless of which apps are involved.

Common questions

Why is my Marketplace Connect inventory not syncing? Work the ladder in order: channel connection status, sync queue backlog, product and variant mapping, inventory location mapping, then rate limits and the order tier. Location mapping is the most common miss — quantities push from designated locations only, and a product fed by the wrong location shows zero or stale numbers.

Can Marketplace Connect set inventory per variant? No, as of October 2026. Inventory location is configurable per product, in bulk, or per regional marketplace — not per variant. If a product's variants live in different locations, the channel can't express that split; consolidate the stock or accept one pooled quantity per product.

Can I still connect Etsy to Marketplace Connect? No — new Etsy connections can't be made at this time, per the Shopify Help Center as of October 2026. Existing Etsy connections continue to work. For new channels, the supported set is Amazon, eBay, Walmart (US), and Target Plus (US).

How much does Marketplace Connect cost? Free to install. The first 50 marketplace-synced orders per month are free; after that, 1% per synced order, capped at $99 per month (App Store listing, as of October 31, 2026). Re-check the listing before committing — pricing tiers change.

A one-of-a-kind item sold but the listing is still live — what now? End the listing manually immediately, and refund if a second order lands. The qty-1 lag is community-reported, not documented, but the safe fix is structural: end qty-1 listings by hand after each sale, or exclude one-of-a-kind SKUs from sync and manage them manually.

Next step

Run rung 4 today on your top-ten marketplace SKUs: open the location mapping for each and confirm the selected locations actually hold the stock. Then put the weekly ten-SKU channel audit on the calendar — the mismatch you find yourself is a field edit; the one a customer finds is an apology. The audit habit itself is documented in the inventory-not-updating guide. If your sync problem is between two of your own stores rather than a marketplace, sharing inventory across multiple Shopify stores covers that architecture. And if a second terminal runs your retail counter, keeping Square and Shopify ledgers in sync has the same source-of-truth logic.