HowTo Schema Generator

Build a complete HowTo JSON-LD block for any tutorial or how-to page. Enter the task name, total time in minutes, optional supply and tool lists, and add ordered steps with name, description, image, and URL. The generator outputs a ready-to-paste <script type="application/ld+json"> tag that qualifies your page for Google's step-by-step rich result — the expandable accordion that surfaces directly in search.

Steps

How to use the HowTo Schema Generator

Enter the name and description of your how-to task. Set total time in minutes — the generator converts it to the ISO-8601 duration format (PT90M for 90 minutes, PT2H30M for 150 minutes). Add supplies (consumable materials) and tools (reusable equipment) one per line. Under Steps, click "+ Add step" for each instruction: give it a short name (e.g., "Mix the dough"), a detailed text description, an optional step image URL, and an optional URL that links to this step's anchor on your page. Step order in the UI matches step order in the output — rearrange by removing and re-adding if needed. Click Generate, then copy and paste the output into your page's <head> or a <script type="application/ld+json"> tag. Validate in Google's Rich Results Test.

What HowTo schema does

HowTo schema (schema.org/HowTo) describes a task that a reader can perform — cooking a recipe, configuring a server, assembling furniture. Google uses it to render a step-by-step rich result: an expandable accordion in search results that shows each step inline, with images. For how-to queries, this accordion can appear above all organic blue links, making it one of the highest-visibility SERP features available to content publishers.

The total time property accepts an ISO-8601 duration (PT1H30M, PT45M). The generator converts your minutes input automatically. Supply and tool arrays help Google understand what physical or digital items the how-to requires — these may surface in the rich result as a materials list. Each HowToStep can carry its own image (ImageObject URL), which may appear in the accordion thumbnail.

Common mistakes that prevent the rich result from appearing: the page URL is in the step\'s url field instead of a step-specific anchor (#step-1); the description is under 50 characters; or steps have duplicate names. Google also requires the full step instructions to be visible in the page body — you can\'t hide the text in the schema only.

Common use cases

  • Recipe and cooking tutorials — Structured steps with timing help users follow along, and the step-by-step accordion appears for "how to make X" queries with high purchase intent.
  • Technical setup guides — Installation and configuration walkthroughs for software, APIs, or hardware qualify for the rich result when steps are properly marked up.
  • DIY and home improvement — Step-by-step instructions for repairs or projects target high-volume "how to fix" queries where rich results increase clicks significantly.
  • Educational how-tos — Tutorial sites covering math, science, or programming concepts can surface step-by-step procedures in SERPs, improving visibility over generic page links.
  • Product assembly instructions — E-commerce and manufacturer sites can mark up assembly guides so Google links them to product search results via the step carousel.

Frequently asked questions

Does HowTo schema directly improve rankings?
No — schema is not a ranking signal. But the step-by-step rich result can appear at the top of SERPs for how-to queries, significantly increasing organic click-through even from a lower-ranked position.

How is HowTo different from Recipe schema?
Recipe schema is a subtype of HowTo with cooking-specific fields (ingredients, cookTime, nutrition). HowTo is the generic parent used for any non-recipe procedural task. Use Recipe for food; use HowTo for everything else.

Is totalTime required?
It's optional but recommended. Google displays duration in the rich result snippet ("15 minutes"), which helps users decide whether to click. The generator formats your minutes as a PT duration automatically.

Can I reuse HowTo schema for content behind a paywall?
No. Google requires the full step text to be accessible to Googlebot. If steps are paywalled, the rich result won't appear. You can mark up a teaser step and note the rest is premium, but hidden steps can't be in the schema.

How many steps can I have?
There is no hard limit, but Google typically shows three to five steps in the accordion. Keeping steps concise and naming them clearly (short imperative phrases) improves how the result looks.