What is HowTo, the step-by-step instructions schema?
HowTo is the Schema.org type that describes instructions for achieving a result through a sequence of steps, with their materials, tools, estimated time and cost. Google used it for an instructions rich result that it stopped showing on mobile in August 2023 and on desktop on September 13, 2023; the type is still current in Schema.org.
Key takeaways
- HowTo describes instructions: each step as a HowToStep, groupable into HowToSection, with what gets used up (supply), what gets used (tool) and the total time.
- On August 8, 2023 Google limited the HowTo result to desktop; since September 13, 2023 it shows it on no device.
- In the same announcement, Google said that structured data it doesn't use causes no problems in Search, though it has no visible effects there either.
- Recipe is a more specific type of HowTo, and the recipe result is still on the list of features Google supports.
If someone proposes marking up your guides with HowTo so they show up in Google with the steps in view, that promise expired on September 13, 2023. The type still exists in Schema.org and is still correct; what disappeared was the Google result that displayed it. It still matters to a store, because instructions are common ecommerce content: how to assemble a piece of furniture, how to choose a size, how to care for a garment or how to install a part. Knowing what the markup does today keeps you from paying for something that no longer delivers what it promised.
What it includes
Schema.org defines HowTo as instructions that explain how to achieve a result by performing a sequence of steps. It is a type of work (Thing > CreativeWork > HowTo) and its properties describe the whole task:[1]Schema.org. HowTo
| Property | What it describes |
|---|---|
step |
Each step: a HowToStep, a text, a document or a video, or a HowToSection that groups several steps under a name.[1]Schema.org. HowTo |
supply |
What gets consumed by following the instructions.[1]Schema.org. HowTo |
tool |
What gets used but not consumed.[1]Schema.org. HowTo |
totalTime |
The total time, preparation included, in an ISO 8601 duration format.[1]Schema.org. HowTo |
prepTime and performTime |
The preparation time and the performance time, separately.[1]Schema.org. HowTo |
estimatedCost |
The estimated cost of what gets consumed.[1]Schema.org. HowTo |
yield |
What you get when you finish; Schema.org's example is a paper airplane or ten personalized candles.[1]Schema.org. HowTo |
HowTo has a more specific type, Recipe, for cooking recipes.[1]Schema.org. HowTo According to the Schema.org page, with data from Google's index as of August 2026, HowTo is used on between 100,000 and a million domains.[1]Schema.org. HowTo
As with any structured data markup, the usual format is JSON-LD, and Google's rule that does not depend on the type still stands: do not mark up content the visitor can't see. If the markup describes some steps, the page has to show those same steps.[2]Google Search Central. General structured data guidelines
What Google did with the HowTo result
Of Google's rich results, the instructions one disappeared in two steps and within a few weeks:
| Date | What changed |
|---|---|
| August 8, 2023 | Google announces that the HowTo result will only be shown to desktop users, not on mobile. It recalls that, with mobile indexing, the mobile version of the site had to carry the markup for the result to appear on desktop.[3]Google Search Central Blog (John Mueller, August 8, 2023, updated September 14, 2023). Changes to HowTo and FAQ rich results |
| September 13, 2023 | Google stops showing the result on desktop too, and declares it deprecated.[3]Google Search Central Blog (John Mueller, August 8, 2023, updated September 14, 2023). Changes to HowTo and FAQ rich results |
| September 14, 2023 | Google removes from its documentation the HowTo structured data guide, because the result is no longer shown on desktop or mobile, along with its case study.[4]Google Search Central. Latest documentation updates |
| The following 30 days | Google announces it is removing the HowTo search appearance in Search Console, its rich results report and its support in the Rich Results Test; support in the Search Console API, within 180 days.[3]Google Search Central Blog (John Mueller, August 8, 2023, updated September 14, 2023). Changes to HowTo and FAQ rich results |
Google framed it as part of its effort to simplify the results page.[3]Google Search Central Blog (John Mueller, August 8, 2023, updated September 14, 2023). Changes to HowTo and FAQ rich results Today, HowTo is not on the list of structured data features Google supports, and Recipe is.[5]Google Search Central. Structured data markup that Google Search supports
What the markup does today
In Google, nothing visible. In the 2023 announcement, Google wrote that structured data it doesn't use causes no problems in Search, though it has no visible effects there either.[3]Google Search Central Blog (John Mueller, August 8, 2023, updated September 14, 2023). Changes to HowTo and FAQ rich results What remains true of any markup is that Google uses the structured data it finds to understand the content of a page and to gather information about the web.[6]Google Search Central. Introduction to structured data markup in Google Search Since it removed the HowTo documentation,[4]Google Search Central. Latest documentation updates Google describes no specific use of that markup, and there is no special markup for its generative AI features either.[7]Google Search Central. Optimizing your website for generative AI features on Google Search
Outside Google, HowTo is still the standard way to describe instructions with structured data: a current vocabulary type, with steps, materials, tools and times that any system that reads Schema.org can interpret.[1]Schema.org. HowTo What really counts is the content it marks up: clear instructions, with the steps in order and the concrete details, are still useful to the shopper even if no search engine dresses them up.
In a store
A made-up example: a furniture store publishes the guide "How to assemble the Arga bookshelf", with the steps visible on the page. The markup repeats exactly what is read:
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "How to assemble the Arga bookshelf",
"totalTime": "PT30M",
"tool": [{ "@type": "HowToTool", "name": "Phillips screwdriver" }],
"supply": [{ "@type": "HowToSupply", "name": "Wall anchors and screws" }],
"step": [
{ "@type": "HowToStep", "text": "Screw the two sides to the base." },
{ "@type": "HowToStep", "text": "Slot the three shelves into the guides." },
{ "@type": "HowToStep", "text": "Fix the bookshelf to the wall with the anchors." }
]
}
It reads like this: totalTime says half an hour in ISO 8601 format (PT30M), the screwdriver is a tool because it isn't used up, the anchors are a supply because they stay in the wall, and each step is a HowToStep with the same text as the guide. That markup goes on the guide's page, not on the bookshelf's product page, which is described with Product. Today it will not produce any special result in Google; what it does give you is a well-written guide that the product page can link to.
What people often get wrong
That, if the Rich Results Test doesn't show your HowTo, the markup is wrong. Google announced in September 2023 that it was removing HowTo support from that tool,[3]Google Search Central Blog (John Mueller, August 8, 2023, updated September 14, 2023). Changes to HowTo and FAQ rich results so its silence says nothing about the markup. To know whether it is well written, the tool is a Schema.org validator; to know whether it is worth anything, the question is whether the instructions on the page are really instructions.
How to check it
- Search for
HowToin the source code of your guides and your product pages. On a product page, not finding it is the normal outcome. - Compare step by step. Each
stepin the markup has to be on the page, with the same words and in the same order.[2]Google Search Central. General structured data guidelines - Validate the syntax with a Schema.org validator, not with the Rich Results Test, which stopped supporting HowTo.[3]Google Search Central Blog (John Mueller, August 8, 2023, updated September 14, 2023). Changes to HowTo and FAQ rich results
- Don't look for it in Search Console. The HowTo search appearance and report were removed in 2023.[3]Google Search Central Blog (John Mueller, August 8, 2023, updated September 14, 2023). Changes to HowTo and FAQ rich results
- Decide what to do with the markup you already have. If it is correct and matches the page, it causes no problems;[3]Google Search Central Blog (John Mueller, August 8, 2023, updated September 14, 2023). Changes to HowTo and FAQ rich results if it doesn't match, fix it or remove it. What makes no sense is creating new HowTo expecting a result Google no longer shows.
Related concept: FAQPage
FAQPage fell in the same announcement, by another route. In August 2023 Google limited the FAQ result to well-known, authoritative government and health sites,[3]Google Search Central Blog (John Mueller, August 8, 2023, updated September 14, 2023). Changes to HowTo and FAQ rich results and in 2026 it stopped showing it altogether and removed its documentation.[4]Google Search Central. Latest documentation updates The difference at heart is in the content: FAQPage marks up questions with their answers; HowTo marks up a task with its steps. An assembly guide is a HowTo; the section "Can it be fixed to a drywall wall?" in that same guide is a frequently asked question.
To go further, the product graph explains what markup does hold up a product page, and the structured data reading path orders the rest of the types.
Synonyms
- English
- HowTo schema, how-to structured data
- Español
- schema HowTo, marcado de instrucciones
Sources
- [1] Schema.org. HowTo. Accessed . ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑
- [2] Google Search Central. General structured data guidelines. Accessed . ↑ ↑
- [3] Google Search Central Blog (John Mueller, August 8, 2023, updated September 14, 2023). Changes to HowTo and FAQ rich results. Accessed . ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑
- [4] Google Search Central. Latest documentation updates. Accessed . ↑ ↑ ↑
- [5] Google Search Central. Structured data markup that Google Search supports. Accessed . ↑
- [6] Google Search Central. Introduction to structured data markup in Google Search. Accessed . ↑
- [7] Google Search Central. Optimizing your website for generative AI features on Google Search. Accessed . ↑
Change history
- First English version.
This definition is published under CC BY 4.0. Reuse this definition freely, crediting Clione with a link to this page.
Related terms
FAQPage
What FAQPage is, how to mark up a frequently asked questions section, why Google retired its rich result in May 2026 and what is still worth doing.
Rich results
What Google rich results are, which ones matter in a store, why valid markup doesn't guarantee you'll see them, and how to check.
Structured data
What structured data is, which pieces make it up, what a store gets from it according to Google, and how to check it matches the product page.
Rich Results Test
What Google's Rich Results Test is, what it checks on a product page, what it cannot see and how to read its errors and warnings.
Speakable
What the Schema.org speakable property is, what Google has used it for since 2018, where it works (U.S., English, news) and whether it helps a store.
Product graph
What a product page's product graph is: the Product, Offer, Organization, Brand and Review nodes linked by @id, and how to check that they are connected.
Make your catalog easy for bots to read
Clione fills every product page with what bots read best: the JSON-LD graph with its structured data, the meta description and the FAQs. You review and press Push; then we check your live store so it all stays published.