Schema markup generator tool by Marco Ilardi

Writing structured data is only half of the job. Before you paste a JSON-LD block into your website you need to check that it is correct, because a single missing comma or a wrong property name can make the whole block unreadable for search engines. This guide explains which validators exist, what each one checks and how to fix the errors you are most likely to meet.

The two tools you need

There are two official tools, and they answer different questions.

Use the first one to make sure the code is valid, and the second when you are aiming at a specific search feature, such as a product listing.

How to validate your markup

  1. Generate your code with the free application on this site, for example the Organization schema generator. Each generator has a validate button that sends the code to the Schema Markup Validator.
  2. Open the validator and choose between testing a public URL or pasting the code snippet.
  3. Run the test and read the result. Errors must be fixed, while warnings describe recommended properties that are missing.
  4. Fix the code, test again, and only then add it to the head of your page.
  5. After publishing, test the live URL with the Rich Results Test to confirm the page serves the code you expect.

Valid does not mean eligible

Code can be perfectly valid and still produce nothing in Google Search. Validity means the syntax and the vocabulary are correct. Eligibility means the type is supported by a Google feature, the required properties are present and the information matches what visitors can see on the page. Even eligible pages are not guaranteed to get a rich result, because Google decides case by case.

The most common errors and how to fix them

Keep monitoring after launch

Google Search Console shows reports for the structured data it finds on your site, and sends alerts when new errors appear. Check it after every redesign or plugin update, since templates often change the markup without anyone noticing. If you are not sure where to place the code, read how to insert a schema in the head section of your website, and for a map of the types worth creating first, see the most important schema.org types.

Sviluppato con Micro WP da Micropedia