NeovaAdvanced SEO Platform

Schema Markup Validator: Check Structured Data on One Page or a Whole Site

Structured data tells search engines what a page is about in a form they can read without guessing: this is a product, this is its price, this is the author. A schema markup validator reads that markup and tells you whether it parses, whether it uses the vocabulary correctly and whether it is complete enough for a search feature. One page is easy to test. A site with thousands of templated pages needs the same test run everywhere.

Structured Dataschema markup validatorUpdated November 21, 2026By the Neova team

What a Schema Markup Validator Checks

Validation happens at four levels, and each one catches a different kind of problem:

  1. Syntax. Does the JSON-LD parse? Is every microdata property inside an item? A missing comma or an unescaped quote can make a whole block unreadable.
  2. Vocabulary. Are the types and properties real Schema.org terms, used on the types they belong to? A misspelled property is valid JSON but means nothing.
  3. Feature requirements. Google documents required and recommended properties for each rich result it supports. Markup can be valid Schema.org and still miss a property Google needs for a product snippet or an event listing.
  4. Match with the page. Google's structured data guidelines ask that markup describe content visitors can see. A price in the markup that is not on the page, or a headline that differs from the visible one, is a quality problem no syntax check will find.

Most one-page tools cover the first three. The fourth needs the markup and the rendered page side by side.

Schema.org's Validator and Google's Rich Results Test

Two free tools test one page at a time, and they answer different questions. Google's introduction to structured data recommends the Rich Results Test while you build.

Schema Markup ValidatorRich Results Test
Made bySchema.orgGoogle
Pages per test11
URL or pasted code✓✓
JSON-LD, microdata, RDFa✓✓
Whole Schema.org vocabulary✓–
Google rich result eligibility–✓
Missing required properties–✓
Result preview–✓

The Schema Markup Validator replaced Google's old Structured Data Testing Tool. Use it to know whether markup is correct Schema.org, including types that feed knowledge panels or AI answers but have no rich result. Use the Rich Results Test when the goal is a specific Google feature. Neither tests a whole site in one go. SEO ProCheck walks through debugging failing rich results with both.

JSON-LD, Microdata and RDFa

Google reads all three formats and says they are equally fine when valid, but recommends JSON-LD because it sits in one script block, apart from the HTML, and is easiest to keep correct across templates. A minimal Product block looks like this:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Trail Running Shoe",
  "image": "https://www.example.com/shoe.jpg",
  "offers": {
    "@type": "Offer",
    "price": "89.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}
</script>

Microdata and RDFa put the same facts in attributes on the visible HTML. That keeps the markup close to the content, but a template change to the HTML can quietly break it. Whichever you use, use one per item; describing the same product twice in two formats invites the two to disagree.

Common Structured Data Errors

  • Broken JSON. A trailing comma, a smart quote pasted from a document, or a raw line break inside a string.
  • Missing @context or @type. Without them, a parser does not know what the block describes.
  • Missing required properties. See the table below.
  • Markup that disagrees with the page. A price that changed on the page but not in the markup.
  • Stale values. An offer whose priceValidUntil has passed, or a dateModified before datePublished.

Required properties for a few common features, from Google's search gallery:

TypeRequired by Google
Product snippetname, plus offers, review or aggregateRating
Eventname, startDate, location
Recipename, image
BreadcrumbListitemListElement: name, position, item
Article0 (all recommended)

Some markup is valid but no longer earns what it did:

MarkupChangeSince
data-vocabulary.orgNot supported2021
HowToNo rich resultSeptember 2023
FAQPageGovernment and health sites onlyAugust 2023
FAQPageNo rich resultMay 2026

Why One Page Is Not Enough

Structured data is almost always produced by templates. When it breaks, it breaks on every page the template serves, or on the subset where one field is empty. Testing the product page you happen to open will not show you that 300 products have no price because their price field is a range, or that articles from one author have no author markup.

Three things only show up across a whole site:

  • Coverage. Which page groups carry markup, and which pages inside a group are missing what their siblings have.
  • Edge cases. Empty fields, odd characters and values that only some records hold.
  • Drift. Markup that was valid at launch and stopped being valid after a release. Google's documentation recommends watching the rich result reports after you deploy for exactly this reason.

How to Validate Schema Markup Across a Whole Site

  1. Crawl the site and extract structured data from every HTML page. If some markup is injected by JavaScript, render the pages too, as described in the JavaScript SEO crawler guide.
  2. Fix syntax errors first. Nothing else can be checked on a block that does not parse.
  3. Group pages by template and list the types each group carries. Look for pages missing a type most of their group has.
  4. Check required properties for the features you want, then the recommended ones.
  5. Compare markup with visible text: names, headlines and prices should appear on the page.
  6. Spot check in the Rich Results Test one page per template, to confirm what Google sees.
  7. Watch Search Console after each release: the rich result reports and URL Inspection show what Google found on its own crawl.

Structured data is one step of the technical SEO audit checklist, and clean markup also helps AI systems read a page, as the AI SEO crawler guide explains.

Validate Structured Data With Neova

Neova's Structured Data category marks the schema markup on each page as valid, with warnings or with errors, adds a Schema Types column, and gives a verdict for each type in the URL panel. It reads JSON-LD, microdata and RDFa from every HTML page in the crawl. Some of the checks:

Because Neova finds page groups from the HTML, a template problem shows up as one group with the same flag rather than thousands of separate rows. Open questions on types and formats are answered in SEO ProCheck's schema markup FAQ. See Features or download Neova; the Free plan crawls 1,000 URLs with every check.

Questions

What is a schema markup validator?

A tool that reads the structured data on a page, in JSON-LD, microdata or RDFa, and checks that it parses, uses Schema.org types and properties correctly and, for some tools, has what a search feature requires.

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

The Schema Markup Validator at validator.schema.org checks markup against the whole Schema.org vocabulary. Google's Rich Results Test checks which Google rich results a page is eligible for and which required or recommended properties are missing.

Does valid structured data guarantee a rich result?

No. Google says valid markup makes a page eligible, not guaranteed. It decides whether to show a rich result based on the query, the page and its quality guidelines.

Can I validate schema markup on a whole site?

Not with the one-page tools. A crawler that extracts and checks structured data on every page shows template problems, missing markup and pages that differ from their group, then you spot check one page per template in the Rich Results Test.

Which structured data format should I use?

Google reads JSON-LD, microdata and RDFa and recommends JSON-LD, since it sits in one block apart from the HTML and is easiest to maintain.

Take this with you

The assistant links open with a question about this page already written.

Crawl your site with NeovaThe Free plan runs every check on Mac, Windows and Linux. No credit card required.

Keep Reading