How Do I Know If My Schema Markup Is Working?


We’re often asked how to check the accuracy of your schema markup once it has been implemented.  When you add Schema markup to your website, sometimes it can be tricky to immediately identify whether that markup is accurate and will contribute to higher click through rates, and rich results.  Fortunately, there are many tools available for you to:

A: Check if your Schema markup has been successfully deployed

The first step is to make sure that your markup is on the page. If you are copying and pasting the JSON-LD into the page, you can simply right click on the web page, view source and search within the elements tab for “LD+JSON” to see if the code is there. If you are using Schema App, or Google Tag Manager to deploy your code, it’s easier to use Google’s Structured Data Testing Tool to see if the markup is present. See below for instructions on how to use the Structured Data Testing Tool. Alternatively, you can wait and check the Google Structured Data Report in Google Search Console to see if Google sees your markup on the page.

For those websites that populate the schema markup dynamically, e.g. using Javascript, then only Google’s Structured Data Report and the Google’s Structured Data Testing Tool will show these results.  Dynamic schema markup requires the testing tool to load the HTML and process Javascript, something Google has supported for a couple years. If you create schema markup using inline HTML (e.g. microdata, RDFa) or the JSON-LD is created Server side and should work with all tools.

B: Check for any errors in the implementation of your Schema markup

It’s very important that you check your Schema markup so you can be sure that it is working hard behind the scenes for your website! We recommend using the Google Search Console Structured Data Report as your source of truth. However, it usually takes a couple of days for your pages to be crawled. While you wait, you can do some quick checking using the tools below. Note, that often Google’s Structured Data Testing tool will give you an error when your markup is absolutely fine. This is why we recommend you use the Google Search Console Structured Data report as your source of truth.

Google’s Structured Data Report – Google Search Console

The Structured Data page in Search Console shows the schema markup (structured data) that Google was able to detect on your site. It provides you information about errors in page markup that may be causing you to not get rich results (snippets, knowledge graph cards, etc) from appearing in search.  This should be where you gauge if your markup as errors or not and if it is being detected.  The report will only show the top level data item. For example, if your page is about a and it has a property, only the Event will be listed in the report.

To find the Structured Data report, Login to Google Search Console (What is Google Search Console) and then navigate to the report under Search Appearance. This will show you what markup is being seen and what errors exist. You can use this to guide what markup you need to update and what markup is being seen by Google.


Google’s Structured Data Testing Tool

This tool is the fastest and easiest to read. When you input your URL and click “Run Test”, it should show all of your Schema Markup in an easy to read format in the field on the right side of the screen. Additionally, you can click on any one of the detected entities and show you the corresponding JSON-LD in the field on the left side of the screen. It will also show any errors and warnings in your markup so that you can make adjustments if needed. Please take a look at our SDTT Error Guide to learn about some common errors and how to fix them.

There are a couple of things about the structured data testing tool that drives our expert team of schema creators crazy. First, the tool often cache’s versions of your page. This means that if you are actively making changes to your markup, the latest markup may not be tested. To overcome this, simply click on new test, and enter your JSON-LD or microdata directly in the tool.  In addition to caching, the structured data testing tool offers stringent errors on schema entities when they aren’t truly relevant. It’s possible that your markup is done accurately, the structured data testing tool doesn’t have the business rule to understand it.


Yandex’s Structured Data Validator

This tool works in a similar way to Google’s Structured Data Testing Tool. It shows all of the schema markup on a page (JSON-LD and Microdata) and labels them accordingly. If you are using Schema App, you would only be interested in looking at the JSON-LD markup.


Structured Data Linter

This tool shows all JSON-LD found on your website. Just put your website URL into the search box and click ‘Submit’. It will display all of your JSON-LD markup. It is a good idea to compare this data to Google’s structured data testing tool so you can fully understand how search engines are reading your site. NOTE: When you type in your website’s URL, you must start with http:// Otherwise the linter will not recognize any Schema markup.


Schema App’s Structured Data Tester

The Schema App Structured Data Tester can be found in the “tools” tab in Schema App. This tool allows you to put in any website URL and it will display the Schema markup found on that page. It is the only testing tool in the world that displays dynamic data and does not cache the results. Having a testing tool integrated within Schema App improves your Schema markup workflow so you don’t always have to go to another site to test your markup.

Getting into the habit of using at least one of these tools when doing your website markup with Schema App is highly recommended. Not only will it confirm whether your markup has deployed correctly, but it will also give you a visual look at the scope of your markup, which will allow you to assess its accuracy.

Click here to learn more about Schema App’s advanced suite of tools for adding Schema markup to your website with ease.

, , , ,
Previous Post
Schema App Tutorial: Organization (Homepage) Markup
Next Post
Schema App Tutorial: Contact Page Schema Markup