Skip to main content
Interface labeled “Rich Results Test” showing structured data code, validation checkmark, and a rich result preview card

Rich Results Test

Validate Structured Data Before You Trust It

SEOWebsiteTechnical
Author
Steven Hsu
Published
Updated

Rich Results Test is Google’s tool for checking whether a page is eligible for rich results in Search. It helps website owners, SEO teams, and developers validate structured data, identify technical issues, and understand which enhanced search features a page may support.

The tool does not guarantee rich results. It confirms whether Google can read the structured data and whether the page is eligible for supported search enhancements. Google still decides whether rich results appear based on many factors, including relevance, quality, query intent, device, location, and search result layout.

Rich Results Test should be used as a validation tool, not as a guarantee of search appearance.

What Rich Results Test Is

Rich Results Test is an official Google tool used to test structured data on a webpage. Structured data gives Google clearer information about a page, such as whether the content is an article, product, event, recipe, FAQ, breadcrumb, or another supported type.

Google describes structured data as a standardized format that provides explicit clues about the meaning and classification of page content. In practical terms, structured data helps search engines understand what the content represents, not just what the visible text says.

When a page has valid structured data, Google may use it to generate rich results. These are search results that go beyond the standard blue link and may include visual or interactive elements such as images, carousels, review details, product information, breadcrumbs, or other enhanced search features.

How Rich Results Test Works

Rich Results Test works by checking whether Google can read the structured data on a page or in a piece of code. It looks for supported rich result types, validates required properties, identifies optional improvements, and shows whether the markup is eligible for Google Search enhancements.

The tool can be used in two ways: testing a live URL or testing pasted code. URL testing is useful for checking the published page, while code testing is useful before a page or schema update goes live.

When the test is complete, the report shows valid items detected, structured data types found, and any errors or warnings that need attention. For example, a page may return valid items for Article, Breadcrumbs, FAQ, and Image Metadata.

When testing a live URL, Rich Results Test shows whether the page was crawled successfully and which structured data items were detected.

This helps confirm whether the published page is eligible for supported rich result types. However, eligibility does not guarantee that Google will show those rich results in Search.

Valid structured data confirms eligibility for rich results in search

Structured data types are identified and validated to ensure proper search enhancements

When testing code, Rich Results Test shows whether the pasted markup is valid and which rich result types are detected.

This is useful during development because structured data issues can be fixed before the markup is published on the live page.

Testing a URL or Code

Rich Results Test gives you two practical ways to validate structured data: testing a live URL or testing code directly.

Testing a URL is useful when the page is already published. It shows how Google reads the final live page, including rendered content, crawl access, structured data, and detected rich result types.

Testing code is useful before publishing changes. You can paste JSON-LD, HTML, or structured data markup directly into the tool to check whether the schema is valid before it goes live.

Testing a live URL checks whether a page supports rich results in search

Testing by URL checks the live published page. This is the best option after a page has been published or updated because it confirms whether Google can access and understand the final version.

Use this method for post-publishing QA, especially after adding or changing structured data.

Testing by code is useful when the page is not live yet or when you are editing structured data before deployment.

You can paste JSON-LD, HTML, or markup directly into the tool and check whether the schema is valid before adding it to the website.

Testing code directly validates structured data before deployment

In practice, both methods are useful. Code testing helps catch issues during development, while URL testing confirms whether the final published page can actually be accessed, rendered, and understood by Google.

When to Use URL Testing

Use URL testing when you need to validate the real published page. This is the best option after structured data has been deployed, after a CMS template has changed, or after a page has been updated.

URL testing is useful because it checks the page as Google can access it, not just the markup you expect to be present. This matters because the live page may include rendering issues, blocked resources, outdated cached templates, missing schema, incorrect canonical signals, or JavaScript-generated markup that behaves differently from the development environment.

Use URL testing for:

  • Published pages
  • Post-launch QA
  • Template changes
  • CMS schema updates
  • Pages affected by JavaScript rendering
  • Final validation before requesting indexing or recrawling

If the live URL test fails but the code test passes, the problem is likely not the schema syntax alone. It may be related to deployment, rendering, crawl access, robots directives, noindex tags, canonical handling, or differences between the tested code and the live page.

When to Use Code Testing

Use code testing when you want to validate structured data before it is published. This is useful during development, while editing JSON-LD, or when testing changes before a CMS template goes live.

Code testing helps catch syntax errors, missing required fields, invalid values, and unsupported rich result types before the markup reaches production. It is especially useful when developers, SEO teams, or content teams are collaborating on schema changes.

Use code testing for:

  • Draft schema markup
  • New templates
  • Pre-deployment QA
  • Debugging JSON-LD
  • Comparing schema versions
  • Testing fixes before publishing

Code testing is useful, but it does not replace URL testing. A pasted code snippet may be valid, but the live page still needs to be crawlable, renderable, indexable, and aligned with the visible content.

Why Rich Results Test Matters

Rich Results Test matters because structured data is easy to implement incorrectly. A page may look fine to users but still contain broken, incomplete, duplicated, irrelevant, or misleading schema markup.

For SEO, this matters because structured data supports search clarity. It helps Google understand what the page is about, what type of content it contains, and which entities or properties are relevant. This does not replace good content, clean structure, or technical SEO, but it strengthens the machine-readable layer of a page.

Rich results can also improve search visibility by making listings more useful and visually distinctive. Google’s documentation explains that structured data can enable special features in Google Search, but eligibility depends on following technical, content, and quality guidelines.

What Rich Results Test Checks

Rich Results Test mainly checks whether the structured data on a page is technically valid for Google-supported rich result types.

It can detect whether required properties are missing, whether values are incorrectly formatted, whether multiple structured data items exist on the same page, and whether the markup matches a supported Google feature. It can also show a preview for some rich result types.

The tool is useful for checking:

  • Supported rich result types
  • Required structured data properties
  • Missing or invalid fields
  • Syntax and formatting issues
  • Detected structured data items
  • Some rich result previews
  • Whether Google can read the tested page or code

However, passing the test does not mean the page will definitely show rich results in Google Search. Google states that structured data can make a page eligible for enhanced appearance, but it does not guarantee that the feature will appear. Some quality issues also cannot be fully tested by automated tools.

Errors vs Warnings

Rich Results Test may show errors, warnings, or valid detected items. These should not be treated equally.

Errors usually indicate that required information is missing, invalid, or unreadable. If an item has errors, it may not be eligible for the rich result type it is trying to support. Errors should be fixed first.

Warnings usually indicate optional or recommended properties that are missing. A warning may not prevent eligibility, but it can still reduce the completeness or quality of the markup. Google’s structured data guidance commonly recommends fixing critical errors first and then reviewing non-critical issues where relevant.

A practical approach is simple:

  • Fix errors first because they affect eligibility.
  • Review warnings second because they may improve completeness.
  • Ignore irrelevant optional fields if they do not accurately apply to the visible page.
  • Retest after every meaningful schema change.

The goal is not to make every warning disappear. The goal is to make the structured data accurate, valid, complete enough, and aligned with the page content.

Rich Results Test vs Schema Markup Validator

Rich Results Test and Schema Markup Validator are related, but they are not the same.

Rich Results Test is Google-specific. It checks whether your structured data can generate Google-supported rich results. This makes it useful for SEO implementation, Search Console validation, and checking whether a page may qualify for enhanced Google Search appearances.

Schema Markup Validator is broader. It validates Schema.org markup in general, including schema types that may not generate Google rich results. Google’s structured data guidelines also note that eligible formats include JSON-LD, Microdata, and RDFa, with JSON-LD recommended.

A practical way to think about it is simple: use Schema Markup Validator to check whether the schema is generally valid, and use Rich Results Test to check whether the page is eligible for Google rich results.

How to Use Rich Results Test Properly

The best way to use Rich Results Test is not just to check whether the page passes. The better approach is to use it as part of a structured QA process.

Start by testing the live URL. This shows how Google reads the actual published page, not just the ideal version of your markup. Then review detected structured data types and confirm that they match the real purpose of the page.

Next, fix all errors first. Errors affect eligibility more directly than warnings. After that, review warnings and decide whether the recommended fields are relevant, accurate, and maintainable.

Finally, compare the result with the actual page content. The structured data should describe what the page already says. It should not be used to force a search appearance that the content does not deserve.

A reliable workflow looks like this:

  1. Identify the page type and the correct schema type.
  2. Add only schema that matches visible page content.
  3. Test the code before deployment.
  4. Publish the markup.
  5. Test the live URL.
  6. Fix errors first, then review warnings.
  7. Validate again after changes.
  8. Monitor Search Console enhancement reports where available.

This turns Rich Results Test from a one-off checker into part of a proper structured data QA process.

Structured Data Should Match Visible Content

One of the most important rules is that structured data should describe the content users can actually see or access on the page.

If the markup says the page contains FAQs, products, reviews, events, authorship details, prices, or ratings, that information should also be represented accurately in the visible page content. Structured data should clarify real content, not create a second version of the page for search engines.

This matters because Google’s structured data guidelines include both technical and quality requirements. Automated tools can catch many technical issues, but they may not catch every quality or policy issue. A page can pass Rich Results Test and still fail to show a rich result if the markup is misleading, irrelevant, hidden, or not representative of the main content.

Limitations of Rich Results Test

Rich Results Test is useful, but it is not a full SEO audit.

It does not guarantee ranking improvements. It does not guarantee that rich results will appear. It does not fully judge content quality, page usefulness, search intent alignment, or whether the structured data is strategically appropriate for the page.

It also does not replace Search Console, URL Inspection, manual review, structured data governance, or real SERP monitoring. A page can pass Rich Results Test and still fail to earn rich results if it does not meet Google’s broader quality expectations or if Google decides the result is not useful for the query.

This is why structured data should be treated as a clarity layer, not a shortcut. It works best when the page itself is already useful, accurate, accessible, and well structured.

Final Thought

Rich Results Test is a practical validation tool for structured data and Google rich result eligibility. It helps identify technical errors, missing properties, detected schema types, and supported rich result opportunities.

But the tool should not be misunderstood. Passing Rich Results Test means the structured data is technically eligible, not that Google will definitely show a rich result.

The real goal is not to game search appearance. The goal is to make the page clearer, more accurate, and easier for search engines to understand.

Used properly, Rich Results Test supports better SEO hygiene, cleaner structured data, and a more reliable search presence.

Frequently Asked Questions

Rich Results Test