Lorixen.
EN

Merchant listings report errors in Search Console: a fix guide

Short answer: Search Console's Merchant listings report checks the Product structured data on pages where shoppers can buy something, and lists items Google considers invalid or that have warnings. Open the report, pick one issue, look at a few affected URLs, and fix the template that produces the markup rather than editing pages one by one. Errors on required fields such as name, image or price stop items from being eligible; warnings are optional improvements. When the fix is live, test a URL and start validation in the report.

What the report covers

Google's documentation on merchant listing structured data explains that there are two Search Console reports for Product markup:

  • Merchant listings for pages where shoppers can buy products.
  • Product snippets for other product-related pages, such as reviews and comparison sites.

Both show errors and warnings for Product structured data, but they're separate because the search features have different requirements. Google adds that the Merchant listings report also includes the checks for product snippets on pages with Offer markup, so an online shop usually only needs the Merchant listings report.

Merchant listings can show price, availability, shipping and return information in Google's shopping experiences. If your markup has errors, your products may not be eligible for those richer displays.

Reading the report

The report groups your product pages into valid items, items with warnings, and invalid items. Google's help page on fixing rich result issues describes the process: open the report, click an issue to see affected pages, and work through the "Why items are invalid" table.

Two practical points from Google's guidance:

  • Fix one issue across all URLs before moving to the next. It's easier to confirm.
  • If an issue comes from a template, fixing the template fixes every page. On a shop, this is almost always the case.

Common errors and what they mean

Google's list of rich result error messages explains the wording you'll see. Translated into shop terms:

Missing field "name", "image" or "offers". Google's merchant listing guide lists name and image as required Product properties, and an offer with a price as required. A missing field can also mean the value exists but is empty, which Google's error list mentions specifically. A theme might output "name": "" when a product title is stored in an unexpected field.

Missing field "price" (in "offers"). Google requires price or priceSpecification.price. Products with variable pricing, quote-only items or "from" prices often trip this.

Invalid price format. Google suggests a valid price format or separating price and currency. Writing "price": "€49" instead of "price": 49 with "priceCurrency": "EUR" is the classic cause. (Values here are illustrative.)

Value must be positive. A price of zero, often from a free sample or a placeholder product.

Invalid object type. A property has the wrong kind of value, for example a plain text string where Google expects a nested object such as an Offer or MerchantReturnPolicy.

Datetime missing a timezone. Dates like priceValidUntil or delivery times should include a timezone when Google's error says so.

Warnings: worth fixing, not urgent

Warnings point to recommended properties you haven't provided, such as shipping details, return policy, ratings or a global product identifier. Google's guide notes that fixing non-critical issues can help the quality of your structured data, though it isn't necessary to be eligible. Prioritise warnings for information shoppers care about. For an Irish shop that offers free delivery or easy returns, showing that data is worth the effort. Add only what's true on the page.

Find the source of the markup

Before editing anything, work out where the structured data comes from. On most shops it's one of:

  • The theme or template.
  • A plugin or app that adds structured data.
  • A product feed tool or tag manager script.
  • Code added by a developer in the past.

Duplicates are common: the theme outputs one Product block and a plugin outputs another. Google sees both, and one may be incomplete. Pick one source and switch the other off.

Test the fix

  1. Rich Results Test. Google recommends validating your code with it. Paste a product URL and check the merchant listing result shows no critical errors.
  2. URL Inspection. Inspect a live URL in Search Console to see what Google currently reads.
  3. Check a few product types: a simple product, a product with variants, an out-of-stock product and a discounted product. Templates often fail on one of these.

Validate in Search Console

Once the fix is live, open the issue in the Merchant listings report and start validation. Google's help page describes the states: in progress, looking good, passed, failed or N/A when the issue was fixed without a validation attempt. If validation fails, the report shows which URLs still have the issue; fix them and wait for the current validation cycle to finish before starting another.

Validation can take a while because Google needs to recrawl affected pages.

A worked example

A hypothetical Cork bike shop sees hundreds of invalid items in the Merchant listings report, all for "Invalid price format". Inspecting a few URLs shows the theme writes the price with a euro sign as text. A structured data plugin also adds a second, more complete Product block. The developer turns off the theme's markup, keeps the plugin's, and checks that it outputs a numeric price with priceCurrency set to EUR. The Rich Results Test shows no critical errors for a simple bike, a bike with size variants and a sold-out model, so the team starts validation in Search Console.

FAQ

Do I need a Merchant Center account for this report?

The report is based on structured data on your pages. Merchant Center is a separate route for product data.

Why does the report show fewer products than my shop has?

It covers pages Google has crawled and detected markup on. New or rarely crawled pages may not appear yet.

Can errors hurt my normal rankings?

The report is about eligibility for rich product displays, not standard ranking. Still, fixing errors is the way to qualify for those displays.

Should I add review ratings to clear a warning?

Only if genuine reviews appear on the page. Don't add markup for content shoppers can't see.

If the Merchant listings report is full of red and you're not sure where the markup comes from, send us your shop's platform and a product URL.

Sources

WhatsAppBook a call