Debug and Analyze

Once you have implemented structured data markup for your pages, you can use Search Console and the Structured Data Testing Tool to find and debug errors as well as monitor the performance of your rich results in Search. This section describes how to keep track of the Search performance of your markup.

Keep track of coverage

Check the number of indexed cards

Use the Rich Cards Report in Search Console to see marked up items that qualify for Rich Card status, such as Recipes. This report categorizes the number of indexed cards into three groups:

  • Invalid cards—cards with missing or incorrect properties. Markup must be fixed before the card can appear in Search.
  • Enhanceable cards—cards that could benefit from additional markup to enhance their appearance on Search.
  • Fully enhanced cards—cards with all available properties provided.

Rich Cards Report

Review structured data markup errors

Use the Structured Data report in Search Console to see the top-level entities discovered on a page. This report shows errors in page markup that might prevent rich snippets or other search features from appearing in Search. See Structured Data Report in the Help Center.

Structured Data Report

Consider creating a sitemap

If the overall number of Rich Cards on your site is lower than you expect, one cause could be that Google did not discover and crawl all your marked-up pages. To help with discovery, consider creating a sitemap of those pages you've marked up and submitting it through Search Console. See Create a List of URLs for details.

Identify and debug Rich Card errors

Check the error examples in Search Console

Errors are grouped by markup type and then by error type—pick out a category and drill down to the example URLs.

Rich Cards Report

Pinpoint issues using the Structured Data Testing Tool

Pick a few sample URLs and test them to see which required fields are missing. Tweak the markup in the tool and see how the results change in the tool in real time.

Once you’ve identified the correct syntax or the correct field content, apply the fix across the site. Things may differ depending on your CMS or site setup, but usually if one item has a specific issue, it is an issue across all items of this type.

Structured Data Testing Tool

Allow time for re-crawling and re-indexing.

As Google reprocesses the updated pages, you’ll see the fixes reflected in the errors reported in Search Console. For those pages you've modified, check the Crawl Errors report in Search Console to make sure that page does not appear in the list. Also, use Fetch as Google tool to verify whether Google can crawl a specific page. Read about Crawl Errors and Fetch as Google in the Help Center.

Monitor performance

Check impressions and clicks in Search Console (currently trusted tester only)

To get an idea of how your marked-up content is performing in Search results, use the Search Analytics report—you’ll see details on queries, impressions, clicks, and Search result positions. Use the Rich results filter to limit results to Rich Cards and Rich Snippets and track how users are interacting with them over time to see if you’re getting the traffic you want.

Search Analytics Report

Identify opportunities for growth

In the Search Analytics report, compare the Rich results queries and impressions with similar stats for content that is not marked up. This helps you see where you can benefit from more attractive results. You might find additional sections of your site where markup could improve traffic.

In addition, review the enhanceable cards in the Rich Cards report. By adding more markup, your cards could stand out even more.

Send feedback about...