Fix guide · Shopify

Fix the Merchant Center availability mismatch in Shopify

Merchant Center checks the availability you submit (in stock, out of stock, preorder or backorder) against what it finds on the product's landing page, including the page's structured data. When the two disagree, it reports a mismatched value for availability, and the item may be limited or disapproved until they match.

What it means

Shopify feed apps read stock straight from Shopify, so the feed is usually current. The mismatch tends to come from the product page: theme or app markup that says InStock no matter what, a single offer that reports the product as available while the variant in the feed is sold out, or a cached page that hasn't caught up with inventory.

Test it free: Paste a product URL: the tester compares every variant's JSON-LD availability and price with the live Shopify store.

Open the structured data tester →

Example diagnosis

A product with one sold-out size, compared with its JSON-LD

Variant             Shopify (live)        JSON-LD on page
Trail Runner / 9    available (4 left)    "availability": "https://schema.org/InStock"
Trail Runner / 10   available (1 left)    "availability": "https://schema.org/InStock"
Trail Runner / 11   sold out              "availability": "https://schema.org/InStock"
(one Offer for the whole product, built from product.available)

The markup has one offer for all sizes, and its availability comes from product.available, which is true while any variant can be bought. Size 11 is sold out, but nothing on the page says so.

The feed sends size 11 as out of stock, because it reads the variant. Google compares that with an InStock page and finds the two disagree.

The fix isn't in the feed. It's in the theme: one offer per variant, each with that variant's own availability.

Symptoms

  • Merchant Center lists items under Needs attention with a mismatched availability (page crawl) issue.
  • The structured data tester shows InStock on a variant that Shopify reports as sold out, or the other way round.
  • Issues cluster on products with many variants, where some sizes or colors sell out before others.
  • Mismatches show up after a sell-out or restock and clear on their own a few days later.

How to fix it in Shopify

  1. Find which variants disagree. Run an affected product URL through the structured data tester. It compares each variant's availability in the JSON-LD with the live store.
  2. Use Shopify's generated markup where you can. {{ product | structured_data }} outputs one offer per variant from the current data. The Product schema fix guide shows where it goes.
  3. In custom markup, take availability from each variant. Loop over product.variants and print https://schema.org/InStock when variant.available is true and https://schema.org/OutOfStock when it isn't. Remove any hard-coded InStock.
  4. Decide how to describe overselling. If a variant has "Continue selling when out of stock" turned on, Shopify reports it as available at zero inventory. If those orders ship later, send backorder with an availability date in the feed and BackOrder in the markup, rather than in stock.
  5. Check caching and apps. Page caching, preorder apps and back-in-stock apps can change what the page shows. Make sure the markup Google crawls matches the buy button a shopper sees.
  6. Request a re-check. After publishing, test the page again, then ask Merchant Center to re-check the item from its issue, or wait for the next crawl.

Caveats and when it applies

  • The availability values differ in name between the two places: the feed uses in_stock, out_of_stock, preorder and backorder; schema.org markup uses InStock, OutOfStock, PreOrder and BackOrder.
  • Preorder and backorder need an availability_date in the feed. Without it, Merchant Center reports a different issue.
  • Merchant Center's automatic item updates can correct a feed's availability from the page. That helps only when the page markup is right, so fix the markup first.
  • Showing crawlers a different stock status than shoppers, on purpose or through a bot-blocking app, is a mismatch Google treats the same way.

Official documentation

The audit checks behind this guide

Test it free: Paste a product URL: the tester compares every variant's JSON-LD availability and price with the live Shopify store.

Open the structured data tester →

Updated 2026-11-03. catalogaudit isn't affiliated with Google or Shopify; the linked documentation is the authority.

Find every product with this problem

The full audit runs this check and every other one on your flagship products, scores your catalog for Google Shopping and AI shopping agents, and rebuilds your five worst products. Free, in about a minute.

Run free audit