How to add HowTo Schema to your how-to article

You might know that structured data in the form of Schema.org can do wonders for your search results. It also forms the basis for an ever-increasing amount of new and exciting developments on the search engine front. Google has said many times that structured data is beneficial. Today, we’re going to look at a relatively new and exciting piece of structured data: the HowTo Schema. This is a how-to about a how-to on HowTo: HowToCeption!

Did you know Yoast SEO now comes with structured data content blocks for the WordPress block editor? You can automatically add HowTo and FAQ structured data to your content! »

What is structured data?

Structured data is a sort of translator for search engines — it adds context to code. Schema.org is a so-called vocabulary, in other words, a dictionary. By adding Schema.org search engines can instantly figure out what every piece of content means, semantically speaking. This gives search engines the power to do cool stuff with your content, like highlighted snippets in search results, the Knowledge Graph or the carousel. There’s structured data for books, articles, courses, events, jobs, local businesses, music, recipes, products, reviews et cetera. Structured data is getting more important by the day and we’ll see more types emerge in the coming years.

If you want to learn more about structured data and find out how to implement it yourself so you can win those coveted rich results, you can enroll in our Structured data training!

What is HowTo structured data?

According to Schema.org, a HowTo is “an instruction that explains how to achieve a result by performing a sequence of steps.” You can use HowTo structured data to mark up articles that come in a how-to form, but that are not recipes. If there is an element of consumption, it should be a recipe.

HowTo Schema.org was introduced in April 2017 and has now made its way to Google’s search engine. Google is always looking at structured data to do cool stuff with, so it’s easy to see why HowTo is an awesome addition to the roster. How about this, since your Google Home can now read your structured data powered recipes out loud, why shouldn’t it be able to read that how-to on how to fix a leaky faucet or change the busted lights in your kitchen cabinet? Google already has an action that works with smart displays. Google has confirmed that it supports new forms of search results snippets, like FAQs or frequently asked questions, Q&As and How-Tos.

That’s cool and all, but isn’t there a lot of code involved in building a how-to page with valid structured data? Yes, but Yoast SEO has an answer to that. Read on, my friend!

How to add HowTo structured data using the WordPress content block in Yoast SEO

Looking for an easy way to add it HowTo structured data to your WordPress site? Well, you’re in luck as we have one! In Yoast SEO, we’ve introduced the concept of structured data content blocks for WordPress’ new block editor. These blocks, including one for HowTo and FAQ structured data, automatically add the necessary code to the pieces of content that you add to this block. Of course, it validates perfectly in Google’s Structured Data Testing tool. Now adding structured data to your how-to article is as easy as filling in the fields!

Here’s how to add a how-to to your site:

  1. Open a post in the block editor or add a new one

    The HowTo content block only works in the WordPress block editor.

  2. Hit the + button and pick the Yoast SEO HowTo content block

    You can add your how-to anywhere you want.

  3. The HowTo content block appears on your screen

    In the block, you’ll find a way to add a total time it takes to do this how-to (optional), a description field, a first step and a step description. You can also add an image per step, delete it and move it up and down the list.

  4. Add the first step

    Give it a relevant, descriptive title and fill in more details for the step, if necessary. Determine if you can make the how-to step made more understandable by adding a relevant image. Sometimes, it might be better to add an image to every step.

  5. Add a second step, a third step and a fourth step

    Add as many steps as you need to get this how-to task done. Need to switch steps around? Use the little up and down arrows next to the Add image button. To delete one, simply hit the trashcan button.

  6. And the structured data? It’s added automatically!

    Really? Yup! You can test it in the Structured Data Testing Tool.

  7. Ready? Check and publish!

    Once you are done, re-read the how-to and publish when ready. Check it to see if everything is in order and easy to understand for your user. If not, make improvements.

  8. Test the how-to in Google’s Rich Results Testing Tool

    You can use Google’s Rich Results Testing Tool to see how your how-to might look in the search results. Here’s an example for our article on How to build an FAQ page.

Testing in the Structured Data Testing Tool

Here you see the result in Google’s Structured Data Testing Tool. Of course, this screenshot is truncated, as the HowTo part of the structured data is fully integrated in the graph Yoast SEO renders. This makes for a beautifully interconnected piece of code, but also very long:

A truncated screencap of the steps in the how-to

Adding structured data to your site with WordPress or Google Tag Manager

In general, adding structured data requires you to edit the code of your pages. For most people, that requires help of their developers. As you see, there is an easier way. Yoast SEO adds a lot of structured data by itself, but you can also add structured data via the dedicated Yoast SEO structured data content blocks for the block editor.

In addition, or if you don’t use WordPress, you can add structured data via the tags, triggers and variables available in Google Tag manager. What’s more, this way of adding your data gives you an extra amount of flexibility as you can save your variables and reuse them or even dynamically fill them. There are loads of options to explore. Annelieke wrote a post on how to add structured data to your site with Google Tag Manager.

Read our Yoast SEO Schema documentation to see how we work with structured data and how you can extend this.

It’s easy to build a how-to with valid structured data

This was cool, right? Well, you can use this for yourself, but keep in mind that it might take a while for search engines to pick this up. Even then, it’s hard to predict if search engines will do anything at all with your structured data. Using the various testing tools give you a good idea of validity of your structured data, but if it leads rich results is up to search engines!

Read more: Structured data: the ultimate guide »

The post How to add HowTo Schema to your how-to article appeared first on Yoast.