Fixing Google Search Console Product Warnings on Your Shopify Store
What those merchant listing and product snippet warnings really mean, which ones are worth fixing, and how to clean up duplicate Product schema for good.
You open Google Search Console, click into Shopping, and there it is: a yellow wall of “Missing field” warnings on your merchant listings. Maybe a few red errors too. It looks alarming, and the report doesn’t exactly explain what to do next.
The good news is that most Search Console product warnings on Shopify come from a handful of predictable causes, and you can fix nearly all of them without touching code. This guide walks through what the warnings mean, which ones are worth your time, and how to clean things up properly so they don’t come back next month.
First, Know Which Report You’re Looking At
Search Console has two reports for product structured data, both under the Shopping section:
- Merchant listings: for pages where a shopper can actually buy the product. This is the one most Shopify stores care about, because it feeds the shopping knowledge panel, Google Images, popular products, and product snippets.
- Product snippets: for product-related pages that don’t sell directly, such as review or comparison pages.
Each report splits issues into two tables. “Why items are invalid” lists critical issues (errors). “Improve item appearance” lists non-critical issues (warnings). That distinction matters more than anything else in this article.
Google’s own rich result report documentation spells it out: an invalid item has at least one critical issue that prevents it from appearing as a rich result, while non-critical issues only affect how the item looks. Keep that in mind before you panic over a big number.
Errors vs Warnings: Fix Errors First
An error means Google couldn’t use the structured data for that product at all. On merchant listings, the required fields are short: the product name, an image, and an offers block with a price and priceCurrency. If any of those are missing or malformed, the product is invalid.
Common causes of errors on Shopify:
- An old app left a half-finished Product schema in your theme files
- A theme customization broke the JSON-LD (a stray comma is enough)
- Products with no price, or a price set to zero
- A second schema on the page that’s missing fields the first one has
Warnings are a different story. They point to recommended fields that make your listing richer. Google says fixing them isn’t necessary to be eligible for rich results, but filling them in can improve how your products appear. So treat errors as urgent and warnings as an improvement project.
The Warnings You’ll See Most Often
Here are the usual suspects in a Shopify merchant listings report, and what each one is actually asking for.
Missing field “shippingDetails” means Google can’t see your shipping cost or delivery time. When it’s present, shoppers can see things like “Free delivery” or an estimated arrival time directly in search results.
Missing field “hasMerchantReturnPolicy” means Google doesn’t know your return window or return fees. Like shipping, this can show up in listings and builds trust before the click.
Missing field “brand”, “gtin”, or “itemCondition” are identification details. They help Google match your product to the right searches and understand whether it’s new, used, or refurbished.
Missing field “review” or “aggregateRating” shows up when a product has no ratings in its schema. If the product genuinely has no reviews, you can leave this alone. Google wants ratings from real customers, not placeholders.
Missing field “priceValidUntil” is a minor one that appears for some schemas. It’s only relevant if you run time-limited sale prices.
One more thing worth knowing: Google’s merchant listing documentation notes that shipping and return policies can also be set at the account level in Google Merchant Center or in Search Console itself. If you define them in several places, product-level feeds in Merchant Center take priority over markup on the page. So if you already manage shipping and returns in Merchant Center, some of these warnings matter less than they look.
The Sneaky One: Duplicate Product Schema
This is the cause we see most often when merchants contact us about product warnings, and it’s easy to miss.
Most Shopify themes ship with their own built-in Product JSON-LD. Then you install a review app, an SEO app, or a “rich snippets” app, and it adds a second one. Now every product page tells Google about the same product twice, often with different details. One block might include your reviews and shipping info, while the theme’s version only has the name and price.
What happens next:
- Google may pick the less complete version and report warnings you thought you’d fixed
- You get conflicting signals, such as two different prices or availability values
- Fixing fields in one schema does nothing because the other one is still there
- Warnings return every time you change apps or update your theme
SEO King’s own in-app help puts it plainly: having multiple JSON-LD script tags on the same page will cause a warning in Google’s tools and may prevent Google from using the most accurate version of your microdata.
How to check for duplicates yourself
- Open any product page on your live store
- Right-click and choose View Page Source
- Search the page (Command + F or Ctrl + F) for
application/ld+json - Count how many blocks contain
"@type": "Product" - Look for HTML comments above each block, which often name the app or theme that added it
If you find more than one Product block, you’ve probably found your problem.
Fixing Product Warnings With SEO King’s JSON-LD Tools
SEO King’s JSON-LD tools were built for exactly this situation. Here’s how the pieces fit together.
Step 1: Let the app check for conflicts
When you open JSON-LD - Products, SEO King scans a product page on your store for existing schema and tells you what it found:
Missing means no product schema was found, so you can go ahead and activate SEO King JSON-LD.
Existing means another schema is already installed. If you activate SEO King JSON-LD, it will attempt to disable it.
Conflict means identical schemas were detected: two or more Product schemas are on the same page.
You can press the View button to open the page in Google’s testing tool and see exactly what Google sees.
Step 2: Remove the theme’s default schema
If the duplicate comes from your theme, go to JSON-LD - Other and use Replace all default theme schemas. This searches your theme code and lets you Disable all theme microdata in one click. If you ever need to undo it, the same section offers Re-enable all theme microdata.
Because this edits your theme files, it’s a good habit to duplicate your theme in Shopify first so you have a backup. If the duplicate comes from another app instead, turn off that app’s schema feature (or uninstall it) so only one source remains.
Step 3: Fill in the fields Google is asking for
This is where most of the warnings disappear. SEO King’s JSON-LD product settings let you add the recommended details without editing code:
- Return Policy URL and Allow Returns for return policy information
- Handling Time, Shipping Time, Free Shipping, and Shipping Region for shipping details
- Include Brand Name, with an option to use your vendor name
- Item Condition for new, used, or refurbished products
- Gender and Age Group for apparel and similar products
- Show a star rating, which pulls ratings from supported review apps such as Judge.me, Loox, Yotpo, Stamped.io, Reviews.io, Fera.ai, Junip, and many others
The product schema also supports advanced types such as ProductGroup for variants, plus shipping rates and merchant return policy data. If you sell in several languages, SEO King’s JSON-LD is automatically translated for your other languages using the translations already in your store.
Step 4: Update your products and keep them updated
Press Update All Products to apply the schema across your catalog. Then turn on the auto-optimize master switch so new products get the same complete schema automatically. Collections have their own tab with Update All Collections if you want collection-level structured data too.
For a deeper look at how product schema and collection ratings work together, see our structured data features or the earlier guide on schema strategy for Shopify stores.
“SEO Kings covers all the essentials: meta titles, product descriptions, sitemaps, and JSON-LD integration for those fancy Google stars. The best part? It takes seconds to set up, and you can apply it to all your products automatically.” — Eyefood Factory Australia, May 2023, ⭐⭐⭐⭐⭐
Verify Before You Tell Google It’s Fixed
Before you click anything in Search Console, confirm the fix is actually live.
- Run a product URL through Google’s Rich Results Test and check that only one Product item appears, with no errors
- In Search Console, use URL Inspection and choose Test Live URL for the same product
- Spot-check two or three other products, including one with variants and one without reviews
A quick note on caching: Shopify’s storefront caching can serve the old version of a page for a short while after a change. If the test still shows the old schema right after you update, wait a bit and try again, or test a product that hasn’t been viewed recently. If the old block is still there after that, go back to the page source and look for which file or app is still printing it.
Click “Validate Fix” and Be Patient
Once your tests look clean:
- Open Shopping > Merchant listings in Search Console
- Click the issue you fixed
- Press Validate Fix
Google then recrawls the affected URLs. Validation isn’t instant. Expect anything from a few days to a couple of weeks, depending on how many products you have and how often Google crawls your store. Resist the urge to restart validation every day, because it just resets the clock.
During validation you’ll often see the numbers move in stages: errors drop first, then warnings trickle down as Google recrawls more products. If a handful fail, open those specific URLs. They’re usually products with something unusual, like a missing image or a zero price.
Keeping Product Warnings From Coming Back
Most recurring warnings come from changes that quietly re-introduce a second schema. A few habits keep things clean:
- After installing a new review or SEO app, check your page source for a second Product block
- After switching or updating your theme, recheck the JSON-LD conflict status in SEO King, because a fresh theme brings its own default schema
- Keep auto-optimize on so new products get complete schema from day one
- Check the Merchant listings report monthly rather than waiting for an email from Google
SEO King’s Scan Issues and SEO Checklist tools are also handy here, since they flag SEO problems across your store and link straight to the tool that fixes them.
“SEO King is hands down one of the best SEO tools for Shopify, offering a fantastic range of features at a very affordable price. It simplifies everything from image optimization to schema markup, making it easy to boost your store’s search rankings.” — SMOKE SHOP, Vape Dubai, September 2024, ⭐⭐⭐⭐⭐
The Short Version
- Fix errors first, because they make products invalid; warnings are improvements
- Duplicate Product schema from your theme plus an app is the most common hidden cause
- Fill in shipping, returns, brand, and condition to clear most warnings
- Test live, allow for caching, then use Validate Fix and give Google time
Clean Up Your Product Schema Today
Product warnings aren’t a disaster, but they are a sign that Google is seeing less about your products than it could. SEO King gives you one complete, conflict-free product schema, the settings to fill in the details Google asks for, and automatic updates as your catalog grows. Flexible plans fit stores of every size.
Install SEO King View live demo
Frequently asked questions
-
Warnings (non-critical issues) don't stop Google from reading your structured data, and they aren't a ranking penalty. They mean Google is missing optional details it could show, such as shipping or return information. Errors (critical issues) are different: they make the item invalid, so that product can't appear as a rich result until the error is fixed.
-
Most Shopify themes output their own Product JSON-LD, and many SEO or review apps add another one. When both are active, Google sees two Product items for one page, which can trigger conflicting or duplicate warnings. Keep one complete schema and remove the others. SEO King's JSON-LD tool detects this and can disable the theme's default schemas for you.
-
Google has to recrawl every affected URL before validation passes, so expect anything from a few days to a couple of weeks depending on how many products you have and how often Google crawls your store. Don't restart validation repeatedly; let it run.
-
Storefront page caching can serve the previous version of a page for a short time after a change. Wait a little, then retest, or check a different product that hasn't been viewed recently. If the old schema still appears after that, search the page source for 'application/ld+json' to see which theme file or app is still adding it.
-
Yes, if a product genuinely has no reviews. Google only wants ratings that come from real customer reviews. If your products do have reviews and you still see the warning, check that your review app is connected. SEO King supports many popular review apps, and our live chat can check whether yours is integrated.
-
No. The JSON-LD is a small script placed in your page's head through a Theme App Embed. It's invisible to visitors, can be switched on or off in your theme's app embed settings, and is removed automatically if you uninstall the app.