Skip to content
Structured Data Testing Guide: Validate Your Schema Markup

Structured Data Testing Guide: Validate Your Schema Markup

4 min read

What Is Structured Data?

Structured data is code added to your web pages that helps search engines understand the content in a machine-readable format. The most common format is JSON-LD (JavaScript Object Notation for Linked Data), which uses the Schema.org vocabulary to describe entities like articles, products, events, recipes, and organizations.

When search engines understand your structured data, they can display rich results: star ratings, product prices, FAQ dropdowns, recipe cards, event dates, and breadcrumb trails that appear directly in search results. These enhanced listings significantly increase click-through rates compared to standard blue links.

However, structured data only earns rich results when it is valid, complete, and free of errors. This structured data testing guide shows you how to validate your markup and fix the issues that prevent rich results from appearing.

Why Testing Structured Data Matters

Adding schema markup without testing is like writing code without running it. Common issues include:

  • Syntax errors — A missing comma, bracket, or quotation mark makes the entire JSON-LD block invalid.
  • Missing required properties — Each schema type has required and recommended properties. Missing a required property disqualifies the markup from rich results.
  • Wrong data types — Providing a string where a number is expected, or a URL where text is expected.
  • Mismatched content — Structured data that does not match the visible page content can be flagged as spam.
  • Deprecated types — Schema.org evolves, and older markup patterns may no longer be valid.

Testing catches these issues before they cost you rich result eligibility.

Structured Data Testing Tools

Google Rich Results Test

The Rich Results Test (search.google.com/test/rich-results) is Google’s official tool for validating structured data. Enter a URL or paste code directly, and it shows:

  • Which rich result types are detected.
  • Whether the markup is valid for rich results.
  • Errors (blocking issues) and warnings (recommended improvements).

This is the most important tool because it reflects exactly what Google sees and supports.

Schema Markup Validator

The Schema Markup Validator (validator.schema.org) validates your markup against the full Schema.org specification, not just Google’s supported subset. This is useful for catching issues that Google’s tool might not flag but that other search engines or platforms use.

Google Search Console

The Enhancements reports in Search Console show structured data performance across your entire site:

  • Which pages have valid structured data.
  • Which pages have errors or warnings.
  • Trends over time showing if issues are increasing or decreasing.
  • Rich result impression and click data.

seokit Schema Generator

The seokit schema generator creates valid JSON-LD markup for common schema types. It enforces required properties, correct data types, and proper nesting, reducing the chance of validation errors before you even deploy.

Browser DevTools

View your page source or use the Elements panel to verify that the JSON-LD script tag is present and contains the expected data. Check that server-side rendering includes the structured data in the initial HTML rather than injecting it via JavaScript after page load.

Common Structured Data Errors

Missing Required Properties

Each schema type has a set of required properties without which Google will not generate a rich result.

Article schema requires: headline, image, datePublished, author.

Product schema requires: name, image, offers (with price and priceCurrency).

FAQ schema requires: mainEntity with at least one Question that has an acceptedAnswer.

Check the Google Search Central documentation for the required properties of each type you implement.

Invalid JSON-LD Syntax

The most common syntax errors:

{
  "name": "Product Name",
  "price": "29.99",   // <-- trailing comma on last property (invalid JSON)
}
{
  "name": "Product "Elite" Edition"  // <-- unescaped quotes (invalid JSON)
}

Use a JSON validator to check syntax before deploying. The seokit schema generator outputs valid JSON-LD automatically.

Mismatch Between Markup and Page Content

Google’s guidelines explicitly state that structured data must reflect the visible content on the page. If your Article schema says the author is “John Smith” but the page shows “Jane Doe,” Google may ignore the markup or flag it as spam.

Using Deprecated Properties

Schema.org occasionally deprecates properties. For example, older Product markup might use offers.price as a string with currency symbol (“$29.99”) when the current specification expects a numeric value with a separate priceCurrency property.

Nesting Errors

Structured data types often nest within each other. An Article contains an author of type Person, which might contain an Organization affiliation. Incorrect nesting, like placing author at the wrong level, breaks the relationship.

Multiple Conflicting Types

Adding both Article and BlogPosting schema to the same page when they describe the same content creates ambiguity. BlogPosting is a subtype of Article, so use BlogPosting for blog posts and Article for news or general articles.

Step-by-Step Testing Process

Step 1: Generate Valid Markup

Use the seokit schema generator to create your JSON-LD. Select the appropriate schema type, fill in all required and recommended properties, and copy the generated code.

Step 2: Add to Your Page

Place the JSON-LD script tag in the <head> or <body> of your page:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Your Article Title",
  "image": "https://example.com/image.jpg",
  "datePublished": "2026-04-05",
  "author": {
    "@type": "Person",
    "name": "Author Name"
  }
}
</script>

Step 3: Validate with Google Rich Results Test

Paste your URL into the Rich Results Test. Address any errors (red) first, then warnings (yellow). Errors prevent rich results; warnings reduce eligibility.

Step 4: Validate with Schema Markup Validator

Run the same URL through the Schema.org validator for a broader check against the full vocabulary.

Step 5: Deploy and Monitor in Search Console

After deploying, monitor the Enhancements reports in Google Search Console. New markup typically takes a few days to a few weeks to be fully processed.

Step 6: Verify Rich Results Appear

Search for your page on Google and check whether rich results are displayed. Note that having valid structured data does not guarantee rich results. Google decides whether to show them based on relevance, content quality, and other factors.

Schema Types Worth Implementing

For All Websites

  • Organization — Your business name, logo, social profiles, and contact info.
  • WebSite — Enables sitelinks search box in Google results.
  • BreadcrumbList — Shows breadcrumb navigation in search results.

For Blog and Content Sites

  • Article / BlogPosting — Headline, author, publish date, and images.
  • FAQPage — FAQ dropdowns in search results.
  • HowTo — Step-by-step instructions with optional images.

For E-Commerce

  • Product — Name, price, availability, reviews, and images.
  • Review / AggregateRating — Star ratings in search results.
  • Offer — Pricing details and availability.

For Local Businesses

  • LocalBusiness — Address, hours, phone number, and service area.
  • Event — Date, location, performer, and ticket information.

Ongoing Structured Data Maintenance

Structured data is not set-and-forget:

  • Review after site redesigns — Template changes can break or remove structured data.
  • Update when Schema.org evolves — New required properties or deprecated fields.
  • Monitor Search Console weekly — Catch new errors before they affect rankings.
  • Test after CMS updates — Plugin updates can change how schema is generated.

Conclusion

Structured data testing is a non-negotiable step in any SEO workflow. Valid markup opens the door to rich results that make your pages stand out in search. Invalid markup wastes effort and can even harm your search presence if flagged as spammy.

Generate clean markup with the seokit schema generator, validate it with Google’s Rich Results Test, and monitor ongoing performance in Search Console. Pair it with the meta tag generator and OG preview tool for a complete on-page SEO setup.