Structured data with Schema.org: the ultimate guide
Schema.org takes care of all the structured data needs on your website. Search engines like Google can pick up this data and present your page in an enhanced way if you use it to describe products, reviews, events, and recipes. If you want rich results like snippets, interactive mobile results, voice-activated actions, or a listing in the knowledge graph, you need to describe your pages with structured data. This structured data ultimate guide is an overview of this wide-ranging topic.
Table of contents
- What is structured data?
- Why do you need structured data?
- Is structured data important for SEO?
- Structured data leads to rich results
- Does structured data work on mobile?
- Different kinds of structured data
- Actions for voice assistants
- The technical details
- What do you need to describe for search engines?
- How to implement structured data
- Structured data and Google AMP
- Tools for working with structured data
- The Yoast SEO Schema structured data framework
- External links
- In the end
What is structured data?
Structured data is a way of describing your website to make it easier for search engines to understand. You need a so-called vocabulary to make it work, and the one used by the big search engines is Schema.org. Schema.org provides a series of tags and properties to describe your products, reviews, local business listings, job postings, et cetera in detail.
The major search engines, Google, Bing, Yandex, and Yahoo, collectively developed this vocabulary to reach a shared language to understand websites better. Today, search engines use it for many things, from fact-checking content to COVID-19 alerting!
If implemented correctly, search engines can use the applied structured data to understand your page’s contents better. As a result, your site might be presented better in search results, for example, in the form of rich results like rich snippets. However, there are no guarantees you’ll get rich results — that’s up to the search engines.
Read more: Schema – why you NEED Yoast SEO to do it right! »
Why do you need structured data?
Describing your products, reviews, events, job postings, and more with structured data in the Schema.org vocabulary makes your site instantly comprehensible by search engines. This means that they can tell exactly what every part of your site is about — and how everything connects. Search engines no longer have to guess that a product listing is a product listing; you can now say it is. Plus, you can define how everything relates.
Is structured data important for SEO?
To cut a long story short: yes, structured data in the form of Schema.org is important for your SEO. Correctly implementing data might not give you better rankings, but it will indirectly make your site a better search result.
Enhanced search results give searchers an easier way to pick a result from the list of links. If your listing is rich and your page does what your listing promises, you are a valid result for the customer, leading to a lower bounce rate. A lower bounce rate tells Google that your site is a well-regarded result that promises and delivers.
Also, since structured data is still picking up steam, you have a good chance of getting a head start on your competitors. This structured data guide shows what you can do.
Structured data leads to rich results
By describing your site for search engines, you’re allowing them to do interesting things with your content. Schema.org and its support are in constant development, so it is improving and expanding all the time. As structured data forms the basis for many new developments in the SEO world — like voice search –, there are bound to be more shortly. Below is an overview of the rich search results currently available; you can find examples of them in Google’s Search Gallery. At the moment, these are a couple of the available rich results:
|Book||Image license metadata||Recipe|
|Breadcrumbs||Job posting||Review snippet|
|Carousel||Job training||Sitelinks searchbox|
|Critic review||Local business||Software app|
|Employer aggregate rating||Movie||Subscription and paywalled content|
The rich results formerly known as rich snippets
Rich results are the extra pieces of information and interactive features shown on a search result page. In addition to the regular black lines of meta description text, you can enhance a search result with product information like prices or reviews or extra navigational tools like breadcrumbs or site search.
Keep reading: Rich snippets everywhere »
Rich results on mobile
Rich results are even more prevalent on mobile. Search results for certain items, like local restaurants, recipes, movies, how-tos, and courses, can get special treatment in the mobile results. These are often presented in a touch-friendly, swipeable way, also known as the carousel.
Google is incredibly interested in getting you to do as much as you can within these results. So, you can book your flight tickets, reserve a spot in a popular restaurant, order movie tickets and send a tasty-looking recipe for cheesecake straight to your Google Home so it can assist you while baking it. Structured data power almost everything. And this is only the beginning.
The Knowledge Graph is the big block of information on the right-hand side in Google. This block details different bits of information about a particular search result. Google fills this graph by checking and evaluating related content about this specific subject. One of the sources it checks is the structured data of a site.
If you have a validated company or an authority on a certain subject, you might see your name, logo, and social media profiles appear.
OK, this might be a sneaky addition because featured snippets are rich results, but they do not get their content from structured data. A featured snippet answers a search question directly in the search results but uses regular content from a web page to do so.
Does structured data work on mobile?
Yes, the results of implementing structured data work everywhere. Mobile is one of the places where the results of a Schema implementation are most visible.
If a page meets the criteria set by Google, you can now book movie tickets or reserve a table at a restaurant directly from the search results. If you implement structured data correctly, you could also be eligible for several interactive extras on the mobile search results pages. In addition, if you add AMP to the equation, you can get even more Google-approved interactive goodies on mobile.
Different kinds of structured data
If you look at the Schema.org website, you’ll notice that there is a lot of information you could add to your site as structured data. Not everything is relevant, though. Before you start implementing structured data, you need to know what you should markup. Do you have a product in an online store? Do you own a restaurant? Or do you have a local business providing services to the community? Or a site with your favorite cheesecake recipes? Whichever it is, you need to know what you want to do and explore the possibilities. Don’t forget to check the documentation by search engines to understand what they need from you.
Don’t go for the most obscure ones; pick the ones that are relatively easy to implement. Some Schema.orgs appear on less than a thousand sites, but others appear on millions. Let’s take a look at a couple of the most important ones:
The Creative Work group encompasses all creative things that have been produced by someone or something. You’ll find the most common ones below, but the list is much longer. You’ll also find properties for sculptures, games, conversations, software applications, visual artworks, and much more. However, most of these properties don’t have a rich presentation in search engine results, so they are less valuable. But, as mentioned earlier, if your site has items in the categories below, be sure to mark them up with Schema.org.
An article could be a news item or part of an investigative report. You can distinguish between a news article, a tech article, or even a blog post.
A book is a book, be it in paper form or in digital form as an eBook. You can mark up every type of property, from the author who wrote it to any awards it has won.
Courses can also appear as a rich result.
Google understands structured data for datasets and can use this to help surface and understand these datasets better. Find out more on Google’s developer pages.
Make a great FAQ page to answer frequently asked questions your customers might have. Yoast SEO helps you turn those FAQs into beautiful rich results in Google with the Schema structured data FAQ content block.
Today, you can markup your how-to articles with HowTo structured data. In the new WordPress block editor, you’ll find our new and free structured data content block for how-tos. By following a step-by-step process, users can get a specific task done. At the moment, there’s no rich result attached to this.
Music also gets the structured data treatment. There are a couple of Schema.orgs of interest for music, like MusicRecording, MusicAlbum, MusicEvent, and MusicGroup.
Question and answer pages are eligible for rich results as well. According to Google, Q&A pages are different from FAQ pages, where you can find multiple questions and answers on a page. More in Google’s Q&A page documentation. Use the Yoast SEO structured data content blocks to provide structured data for your FAQ pages.
By adding Recipe data to the recipes on your cooking website, you can get your recipes featured directly in search results. What’s more, with the advent of mobile rich results, recipes might even be presented in a stunning new way on mobile featuring great images — if you add them. And that’s not all, because you can now send your recipes to Google Home and get Assistant to speak it out loud for you. How cool is that?
Google is currently testing the implementation of speakable Schema.org. With this code, you can tell a search engine that a piece of content is specially written to be spoken aloud by digital assistants like Alexa, Siri, Cortana, or Google Assistant.
TV & Movies
Movies and TV shows get their own piece of structured data as well. Searching for a movie in search engines will yield a rich result with reviews, poster art, cast information, and even the ability to directly order tickets for a showing. You can even mark up lists of the best movies ever made or your favorite TV shows. What’s more, get your visitors to watch the content directly by adding ViewAction or Watch Action structured data.
It’s possible to do all kinds of interesting things with video. Google, in particular, is working on new ways to display videos in the search results.
Have a podcast? Why not mark up your podcast with structured data so Google can do cool stuff with it, like showing each episode’s description and even adding a play button as well.
There are also structured data for commercial goals. Here, you’ll find a couple of important ones:
Marking up your event listings with the correct Event Schema.org, might lead to search engines showing your events directly in the search results. This is a must-have if you own a nightclub, a venue, or any business that regularly puts on events.
Businesses and organizations
If you make money with your website, chances are you own a business. If you’re a site owner or work on a company site, you’ll find the business and organization Schema.orgs interesting. Almost every site can benefit from the correct business Schema.org. If you do it well, you could get a nice Knowledge Graph or another type of rich listing in the search engines. You can even add special structured data for your contact details so customers can contact you directly from the search results. For local businesses, our Local SEO plugin helps you take care of all your local structured data needs.
Read on: Local business listings with Schema.org and JSON-LD »
Have job postings on your site? Mark them up with the job postings structured data to have them show up nicely in Google. We use this on all our Yoast job postings as well.
Schema.org for products is almost as important as the one for businesses and organizations. Using Product Schema.org, you can give your products the extra data search engines need to give you rich snippets, for example. Think about all the search results you see with added information, like pricing, reviews, availability, etc. If you have products, this should be a major part of your structured data strategy. Don’t forget to mark up your product images.
Keep on reading: Rich snippets for product listings with Schema.org »
Reviews and ratings play an important role in today’s search process. Businesses, service providers, and online stores all use reviews to attract more customers and show how trustworthy their offer is. Getting those five stars in search engines might be the missing link to creating a truly successful business.
Read more: Grow your business with ratings and reviews »
Actions for voice assistants
Voice assistants are all the rage, and we will see a lot happen in this space. Take recipes, for instance; you can send a recipe from the search results — powered by structured data and AMP — to your Google Home to read aloud while cooking. These are called Actions, and there are a whole bunch of them. If you want your recipes to appear in the Google Assistant library, you need to add a specific structured data set and adhere to additional rules. You can find more on that on the Creating a recipe action page. Visit Google’s Assistant site to get a feel for what’s possible (a lot!).
The technical details
To get started with marking up your pages, you need to understand how Schema.org actually works. If you look closely at the full specs on Schema.org, you’ll see a strict hierarchy in the vocabulary. Everything is connected, just like everything is connected on your pages. Scroll through the list to see all the options at a glance and note down the ones you think you need.
Let’s look at the hierarchy. A Schema.org implementation starts with a Thing; this is the most generic type of item. A Thing could be a more specific type of item, for instance, a Creative Work, an Event, Organisation, Person, Place, or Product.
For example, a movie is a “Thing” and a “Creative Work”, which falls under the category “Movie”. You can add a lot of properties to this, like a “Description”, a “Director”, an “Actor”, a poster “Image”, “Duration” or “Genre”. There are loads of properties to add, so you can get as specific as you want. However, don’t go overboard since not search engines use every property – at least not yet anyway. You should look at the specifications in Google’s documentation, for instance, to see which properties are required and which are recommended.
A sample Schema.org hierarchy
If we put what we know now in a hierarchy, this is what you will end up with:
- Creative Work
- Description (type: text)
- Director (type: person)
- Actor (type: person)
- Image (type: ImageObject or URL)
- Creative Work
If it would be a local business, you could use something like this:
- Organisation (or Place)
- Organisation (or Place)
For local businesses, you could pick a more specific type of business. This makes it easier for search engines to determine what kind of business you own. There are hundreds of types of local businesses, but your business might not fit one of the descriptions. Using the Product Types Ontology you can get more specific information if your listing is too broad.
Sticking to the local business example, you’ll see that Google lists several required properties, like the NAP (Name and Phone) details of your business. There are also loads of recommended properties, like a URL, geo-coordinates, opening hours, etc. Try to fill out as much of these as you can because search engines will only give you the full presentation you’re looking for. You’ll find our Local SEO plugin very helpful if you need help with your local business markup.
What do you need to describe for search engines?
Looking at Schema.org for the first time might feel a bit daunting. The list is enormous, and the possibilities are endless, so it’s easy to become overwhelmed. To get over this, you need to go back to basics. Think about what your site, business, or product is about and write down the specifications and properties you feel are important, then work your way up from there. Also, Yoast SEO covers the most important properties automatically — so no need to worry about those if your plugin is configured correctly!
Having said that, there are a couple of sections you should prioritize in your plan to add structured data to your site. If you start with these three, you’ll have the basics covered, and then you can build on that. You should absolutely start with structured data for your business details, products, and reviews. These will have the biggest effect in the short term.
How to implement structured data
Don’t be frightened, but here comes the technical part of the story. Before we do that, we’d like to remind you that Yoast SEO comes with a crazy good structured data implementation out of the box. For most sites, it’ll automatically take care of the most pressing structured data needs. Of course, you can extend our structured data framework, as mentioned below, as your needs become bigger.
Do the Yoast SEO first-time configuration and get your site’s structured data set up in a few clicks! The first-time configuration is available for all Yoast SEO Free and Premium users to help you get your plugin configured correctly. It’s quick, it’s easy, and doing it will pay off. Plus, if you’re using the new block editor in WordPress you can also add structured data to your FAQ pages and how-to articles using our structured data content blocks.
Structured data with JSON-LD
JSON-LD is the preferred method of adding structured data to your site. However, not all search engines have been quick to adopt it — Bing being the last hold-out. Thankfully, Microsoft came round in August 2018 and now supports this, the most efficient method.
Ever since Yoast SEO 11.0, the plugin comes with a fully-featured Schema.org implementation. Yoast SEO now creates a structured data graph for every page on your site, interconnecting everything. While working on this, we’ve also created complete and detailed documentation on Schema, including a specification for integrating structured data. Here you’ll also find some example graphs for various kinds of common pages on your site.
If you want to learn more about working with all this on your site, you should read our article on how to use JSON-LD to add Schema.org data to your website, adding structured data to your site with Google Tag Manager, or learn how to add structured data with our training on structured data and SEO, part of our Yoast SEO academy training subscription.
The old ways: RFDa and Microdata
The classic way of writing structured data for inclusion on your pages involves directly embedding it into your HTML. This made a really inefficient and error-prone process and is much of the reason why the uptake of Schema.org hasn’t been swift. Writing and maintaining it via RDFa or Microdata is a pain. Believe us, try to do as much as you can in JSON-LD.
Microdata needs itemprops to function, so everything has to be inline coded. You can instantly see how that makes it hard to read, write and edit.
Structured data and Google AMP
The open-source AMP project (Accelerated Mobile Pages) has been causing quite a stir. The project aims to get pages to load lightning fast on mobile using a special kind of HTML. Google is pushing AMP pretty hard and also mentions its reliance on structured data. If you want particular rich results, you might have to use AMP and add that specific structured data.
Tools for working with structured data
Yoast SEO handles a lot of structured data for you automatically in the background. You could extend our Schema framework, of course — see the next chapter –, but if adding code by hand seems scary, you could try some of the tools listed below. If you are still not sure how to go about this, ask your web developer for help. They will probably fix this for you in a couple of minutes.
- Validators and test tools
- WordPress Plugins
- Yoast SEO Local (Our Local SEO plugin adds Schema.org for your business details, like address, geo-location, opening hours, etc.)
- The Yoast SEO WooCommerce plugin outputs product Schema to get your products highlighted in search.
- Yoast SEO uses JSON-LD to add Schema.org information about your site search, your site name, your logo, images, articles, social profiles and a lot more to your web pages. We ask you if your site represents a person or an organization and adapt our structured data based on that. Also, our structured data content blocks for the WordPress block editor make it easy to add structured data to your FAQs and How-to’s.
The Yoast SEO Schema structured data framework
Implementing structured data has never been really easy. Also, the results of the majority of those implementations were often lacking. At Yoast, we set out to enhance the Schema output by millions of sites. For this, we built a Schema framework — ready to be adapted and extended by anyone. One of the things we did, is combine all those loose little bits and pieces of structured data that appear on many sites, improve these, and put them in a graph. By interconnecting all these bits, we offer search engines all your connections on a silver platter.
Of course, there’s a lot more to it. We can also extend the output of Yoast SEO by adding specific pieces of Schema, like how-tos or FAQ. For this, we built structured data content blocks for use in the WordPress block editor. Together, these help you remove barriers for search engines and users alike — as it has never been easier to work with structured data.
Read the Yoast SEO Schema documentation if you want to learn how Yoast SEO works with structured data, how you can extend it via an API, and how you can integrate it into your own work.
Keep reading: Open-source software, open Schema protocol! »
Most search engines have their own developer center where you can find more information on the inner workings of their structured data implementations. Read these to see what works and what doesn’t. It would be best to stick to their rules because a bad Schema.org implementation could lead to a penalty. Always check your code in the structured data test tool to see if it’s correct. Fix errors and regularly maintain the code on your site to see if it is still up to scratch.
- Google’s Introduction to Structured Data
- Bing’s Marking Up Your Site with Structured Data
- Yandex’ Schema.org for Webmasters
In the end
You can’t run away from structured data anymore. If your site means anything to you, you should look into it and figure out the best way to make use of Schema.org. Still need some help? Read more on how Yoast SEO makes it easy for you. Or check out our digital story on rich results, structured data and Schema. Because implemented correctly, it can do great things for your site, now and in the future. Search engines are constantly developing new ways to present search results, and more often than not, they use Schema.org data.
Adding structured data to your site is an essential part of technical SEO. If you’re wondering how fit your site’s overall technical SEO is, take our technical SEO fitness quiz to find out. This quiz helps you figure out what you can still work on!
Read on: How to check the performance of your rich results in Google Search Console »
Coming up next!
WordCamp EuropeJune 08 - 10, 2023 Team Yoast is Attending, Organizing, Speaking, Sponsoring WordCamp Europe. Click through to see who we'll be there, what we'll do there and more! See where you can find us next »
Yoast SEO news webinar - June 20, 202320 June 2023 Our head of SEO, Jono Alderson, will keep you up-to-date about everything that happens in the world of SEO and WordPress. All Yoast SEO webinars »
2 Responses to Structured data with Schema.org: the ultimate guide
I would love for you to include the event schema and possibly a block to make my posts about events. I am currently using another plugin just for that feature. Please would you consider adding event schema options. Thank you
Hi Ali! Thanks for your suggestion, I will pass it on to my colleagues :)