How to Add HowTo Schema to a Tutorial Page (Step by Step)

HowTo schema is JSON-LD structured data that describes a set of steps a reader follows to complete a task. If you publish tutorials, walkthroughs, or fix-it guides, marking them up with HowTo schema tells search engines exactly what each step is. Here is how to build it correctly and what to expect from it today.

What HowTo schema contains

A HowTo block is a single JSON-LD object with a few core fields:

• name: the overall task, such as “How to reset a router.”
• step: an ordered array of HowToStep items. Each step holds text (the instruction), and optionally name, image, and url that points to that step on the page.
• tool and supply (optional): things the reader needs, like a screwdriver or an account.
• totalTime (optional): an ISO 8601 duration such as PT15M for fifteen minutes.

The most important rule: the steps in your markup must match the steps a reader actually sees on the page. Schema that describes content that is not visible can be ignored or flagged.

Generate your HowTo schema

The fastest path is to let a tool assemble the JSON-LD for you. The HowTo Schema Generator takes your task name and steps and outputs valid markup you can paste straight into your page.

1. Open the HowTo Schema Generator and enter the task name.
2. Add each step in order, with its instruction text and an optional image or anchor URL.
3. Fill in optional fields like total time, tools, and supplies if they apply.
4. Copy the generated JSON-LD and paste it into your page inside a <script type="application/ld+json"> tag.

Everything runs in your browser. Your content is never uploaded, and there is no account or signup.

A note on rich results

Be realistic about the payoff. Google has greatly reduced HowTo rich results in search, so treat visual eligibility as limited and best-effort rather than guaranteed. The markup still has value: it describes your page clearly for any consumer of structured data, and it costs nothing to include accurate schema. Just do not build your content strategy around a HowTo carousel that may never appear.

Validate before you publish

Whatever you generate, confirm it parses cleanly. Run your page or pasted snippet through Google’s Rich Results Test and the Schema Markup Validator. Check that every step has text, that the step order matches the page, and that any totalTime uses ISO 8601 duration format. Fixing errors before publishing saves you from silent failures later.

Related tools

• Article Schema Generator: mark up the surrounding post itself, not just the steps.
• FAQ Schema Generator: add question and answer structured data to the same page.
• Favicon Checker: confirm your site icon renders correctly in search and tabs.

Enter your steps, copy the JSON-LD, validate it, and ship. Accurate HowTo schema is quick to add and keeps your tutorials clearly described.