Google results

How to test schema markup (and fix the errors)

A single missing comma can make structured data invisible to Google. Here's how to test schema markup, read the errors, and fix the problems that come up most.

Structured data (schema markup) only helps if search engines can read it. Testing catches two kinds of problems: syntax errors, where the code itself is broken, and content errors, where the code is valid but missing fields Google needs.

Test any page's schema

Enter a page in the checker on this page. It finds every JSON-LD block, microdata item and schema type on the page, flags broken JSON, and checks the required and recommended fields for the types Google uses.

Free tool

Schema Markup Checker

Paste a page address. See every schema.org item on it, what's wrong, and the exact line where broken JSON-LD fails.

Free, no sign-up. Clarnic reads the page the way a search engine does.

Open the full Schema Markup Checker page →

The three main testing tools

ToolWhat it checksUse it when
A schema checker like this oneSyntax, types found, required fieldsQuick checks on any page
Google Rich Results TestEligibility for Google's rich resultsBefore and after publishing
Schema Markup Validator (validator.schema.org)Full schema.org vocabulary, all typesTypes Google doesn't use for rich results

Google's Rich Results Test only reports on types that produce rich results. If you use other schema types, the schema.org validator covers them.

Errors vs warnings

  • Errors (required fields missing or invalid) stop the item from qualifying for a rich result. Fix these.
  • Warnings (recommended fields missing) don't block eligibility, but adding the fields gives Google more to show.

The most common schema errors

Broken JSON

A trailing comma, a missing quote or a curly quote pasted from a word processor breaks the whole block:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Trail Shoe",
}

That final comma after "Trail Shoe" makes the JSON invalid. Remove it.

Missing required fields

A Product needs a name and at least one of offers, review or aggregateRating. An Event needs a name, start date and location. Each type's requirements are listed in Google's structured data documentation.

Wrong value formats

  • Dates should be ISO 8601: 2026-11-04 or 2026-11-04T19:00:00-05:00.
  • Prices should be numbers without currency symbols: "price": "49.99" with "priceCurrency": "USD".
  • Availability should be a schema URL: https://schema.org/InStock.

Markup that doesn't match the page

Ratings, prices or FAQs in the code that visitors can't see on the page break Google's guidelines and can lead to a manual action.

Duplicate or conflicting blocks

A theme and an SEO plugin each adding their own Product or Organization block, with different values. Keep one.

A simple testing routine

  1. Test the code before publishing with a validator.
  2. Test the live page after publishing, because plugins and templates can change the output.
  3. Check Search Console Enhancements reports weekly for new errors across the site.
  4. Retest after theme or plugin updates.

If you need to build markup from scratch, the schema markup generator produces valid JSON-LD you can paste straight in.

Questions

How do I test schema markup?

Run the page through a schema checker or Google's Rich Results Test. For schema types Google doesn't use, use the Schema Markup Validator at validator.schema.org.

What is the difference between the Rich Results Test and the Schema Markup Validator?

The Rich Results Test checks eligibility for Google's rich results only. The Schema Markup Validator checks any schema.org type against the full vocabulary.

Do schema warnings matter?

Warnings don't stop a rich result, but adding the recommended fields gives Google more information to display.

Why is my valid schema not showing in Google?

Valid markup makes a page eligible, not guaranteed. Google decides per search, and some types like FAQ and HowTo are restricted or retired.

See what to fix on your website today.

Free plan, no credit card. Your first fixes in about a minute.