Skip to content

Structured data errors explained

The messages Search Console and the Rich Results Test show most often, what each one actually means, and the fix. Wording varies slightly between Google's tools and over time.

error

Unparsable structured data

What it means. The JSON-LD block isn't valid JSON, so Google discards all of it. Search Console groups these by the parse error it hit (e.g. "Missing ',' or '}'").

Fix. Paste the block into the JSON-LD validator; it marks the line and column and names the cause: trailing comma, curly quotes, raw line break, stray comment.

warning

Missing field "review"

What it means. A non-critical Product warning. review is recommended, not required.

Fix. If offers or aggregateRating is present, the item can still be eligible. Add real reviews that appear on the page, or ignore the warning.See a valid example.

warning

Missing field "aggregateRating"

What it means. Also recommended, not required, for Product snippets.

Fix. Add it only if the page shows real ratings. Never fabricate a rating to clear the warning.See a valid example.

error

Either "offers", "review", or "aggregateRating" should be specified

What it means. A Product snippet needs at least one of the three; this Product has none.

Fix. Add an Offer with price and priceCurrency for a product you sell, or genuine review data for a product you review.See a valid example.

error

Invalid object type for field "brand"

What it means. brand holds a value of the wrong kind, often plain text or a Person.

Fix. Use {"@type": "Brand", "name": "…"} (Organization is also accepted by schema.org).See a valid example.

error

Invalid price format in property "price"

What it means. price contains a currency symbol, a thousands separator, or a range.

Fix. Digits and a dot only ("1299.00"). Put the currency in priceCurrency; use AggregateOffer with lowPrice/highPrice for a range.See a valid example.

warning

Missing field "priceValidUntil"

What it means. An older Product warning; priceValidUntil is optional.

Fix. Add a future date if the price has an end date. A date in the past is worse than none.See a valid example.

warning

Missing field "hasMerchantReturnPolicy" / "shippingDetails"

What it means. Merchant listing warnings. Google recommends return and shipping info, set either in markup or in Merchant Center.

Fix. Add a MerchantReturnPolicy and OfferShippingDetails, or configure them at account level in Merchant Center.See a valid example.

error

Invalid value in field "itemReviewed"

What it means. The reviewed thing is a type Google doesn't support for review snippets, or is missing its name.

Fix. Review a supported type (Product, Recipe, Book, Course, SoftwareApplication, and others) and give it a name.See a valid example.

error

Value in property "ratingCount" must be positive

What it means. An AggregateRating with zero ratings.

Fix. Leave aggregateRating out until there is at least one real rating.See a valid example.

error

Rating is out of range

What it means. ratingValue is higher than bestRating or lower than worstRating. Google assumes 1–5 when they aren't given.

Fix. Set bestRating (and worstRating) to the scale you actually use, e.g. 10.See a valid example.

error

Invalid date/time format / Invalid datetime value

What it means. A date isn't ISO 8601, e.g. "March 2, 2026" or "02/03/2026".

Fix. Use 2026-03-02 or 2026-03-02T08:00:00+01:00.See a valid example.

warning

Datetime property is missing a timezone

What it means. A date-time without an offset, so Google has to guess the zone.

Fix. Add +01:00, -05:00 or Z to the time.See a valid example.

error

Missing field "location" / "address"

What it means. Events need a location; a physical Place needs an address.

Fix. Add location: {"@type": "Place", "name": …, "address": {"@type": "PostalAddress", …}}, or a VirtualLocation for online events.See a valid example.

error

Missing field "item" (in itemListElement)

What it means. A breadcrumb step that isn't the last one has no URL.

Fix. Give every crumb except the current page an absolute item URL.See a valid example.

error

Missing field "thumbnailUrl" / "uploadDate"

What it means. Both are required for VideoObject.

Fix. Add a crawlable thumbnail image URL and the upload date in ISO 8601 with a time zone.See a valid example.

error

Missing field "hiringOrganization"

What it means. JobPosting requires the employer.

Fix. Add hiringOrganization as an Organization with name, and ideally sameAs and logo.See a valid example.

warning

Incorrect value type / The property X is not recognised by the schema

What it means. A misspelt or wrongly cased property ("Brand", "datepublished") that the parser ignores.

Fix. Property names are case-sensitive. The validator suggests the nearest real schema.org name.

Finding which line is at fault

Search Console names the error and the affected URLs but not the line. Test one affected URL with the URL tester or paste its markup into the validator: each issue is keyed to a line mark in the margin. Fix the template, not just the page, and then use "Validate fix" in Search Console.

Questions

What is the difference between an error and a warning in Search Console?

Errors (shown as invalid items) make that item ineligible for the rich result. Warnings are about missing recommended fields; the item stays valid and can still appear.

How long until Search Console shows my fix?

Only after Google recrawls the pages. Use "Validate fix" in the enhancement report to ask Google to recheck the affected URLs; it can take days.

Why does Search Console report errors the Rich Results Test doesn't?

The report reflects the last crawl, which may be older than your fix, or a different template variant (logged-in state, out-of-stock products, another locale).