If your content walks people through a task, assembling furniture, setting up a router, tying a knot, HowTo schema lets you describe those steps in a way search engines understand. It marks up each step, and any tools or materials needed, so the structure of your instructions is machine-readable. This guide explains what HowTo schema is, the properties that matter, an important caveat about how Google currently uses it, and how to add it.
What HowTo schema is
HowTo schema is structured data (usually JSON-LD) using Schema.org’s HowTo type. It describes a set of instructions to accomplish a task: the overall goal, an ordered list of steps (each with text and optionally an image), and any supplies or tools required. It turns a how-to article from a wall of prose, as far as a machine is concerned, into a clearly structured sequence of steps.
The properties that matter
The structure revolves around steps:
| Property | Role |
|---|---|
| name | The task the how-to accomplishes |
| step (HowToStep) | Each ordered step, with text and optional image |
| tool | Tools needed to complete the task |
| supply | Materials consumed in the task |
| totalTime | How long the whole task takes |
The ordered step list is the heart of it, each step should map to a real, discrete instruction in your content.
An important caveat
Here is something you should know before investing effort: Google has significantly scaled back the visual HowTo rich result, and for most sites it no longer appears as a distinct enhanced listing the way it once did. That does not make the markup worthless, it still helps search engines and AI systems understand the structure of your instructions, which supports comprehension and can help your content be parsed and cited, but you should not add it expecting a guaranteed rich card in Google. Set expectations accordingly: HowTo schema is now more about machine-readable clarity than a flashy SERP feature. We mention this plainly so you can decide whether it is worth it for your content rather than being surprised later.
Mark up genuine steps, in order
As with all structured data, HowTo markup must reflect the real, visible content of the page. Each HowToStep should correspond to an actual step shown to the reader, in the same order, and the tools and supplies should be the ones the task genuinely needs. Do not invent steps, pad the list, or mark up a how-to on a page that is not actually a how-to. The markup describes your content; it does not replace or embellish it. When your page already lays out clear, numbered steps, the schema simply mirrors that structure, which is exactly how it should be.
HowTo vs FAQ vs Article
It helps to pick the right type for your content. Use HowTo when the page teaches a task through sequential steps. Use FAQ schema when the page answers a set of discrete questions. Use Article schema for general informational or news content. A single page usually fits one primary type, and choosing the one that genuinely matches your content is more effective than stacking types that do not apply. If your “how-to” is really a list of tips rather than ordered steps, HowTo may not be the right fit, and forcing it adds noise rather than clarity.
Generate and validate your HowTo schema
Building a nested HowTo with an ordered step list by hand is tedious. Our free HowTo schema generator builds valid markup from your steps, tools and supplies, ready to paste in. Confirm it parses with our schema validator. For related step-based and question-based content, see our guides to schema markup and adding FAQ schema.
The takeaway
HowTo schema describes step-by-step instructions in a machine-readable form, an ordered list of steps plus the tools and supplies a task needs. Be aware that Google has scaled back the visual HowTo rich result, so its value now lies mainly in structural clarity for search engines and AI rather than a guaranteed SERP feature. Mark up genuine, ordered steps and pick the schema type that truly fits your content. Generate valid markup with our HowTo schema generator, and explore the rest of our free SEO tools.