Import existing JSON-LD(paste code or read it from a URL)
Paste a HowTo JSON-LD block, several script tags or a whole page's HTML. The form fills with what it finds so you can edit and improve it.
Guide details
Supplies and tools
Supplies (used up)
Tools (not used up)
Steps
Give steps a section name to group them into a HowToSection, such as Preparation and Assembly. Images and anchor URLs are optional.
Video (optional)
- A how-to usually has at least two steps.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "HowTo"
}
</script>How to use
Describe the guide
Enter the title, description, page URL, image, total time in minutes and estimated cost, or press Load example to see a filled form. Paste existing HowTo JSON-LD to load it instead.
List supplies, tools and steps
Add supplies and tools one per row. Add each step with its instruction and, if you like, a section name, short name, image and anchor URL, or paste all steps at once.
Copy and validate
Choose JSON-LD or Microdata, press Copy script and check it with Validate at validator.schema.org. The Google test link is hidden because Google no longer reports on HowTo.
Why HowTo Schema Generator
- Supplies, tools, cost, time and steps in one form.
- Steps grouped into HowToSection by name.
- Paste a numbered list to create steps.
- Honest about HowTo rich results ending in 2023.
HowTo, Recipe or ItemList: which to use
Step-by-step content can be described three ways. The choice depends on what the page teaches and which search features still exist for it.
| Page | Type | Google feature today |
|---|---|---|
| Fixing, building or setting something up | HowTo | None since 2023; valid for other readers |
| Cooking a dish | Recipe | Recipe rich results and carousels |
| A numbered roundup such as Top 10 tools | ItemList | Carousels for some item types |
| A how-to video | VideoObject with key moments | Video results with key moments |
Good practice for HowTo markup
Keep the markup a faithful copy of the visible guide.
- Every step in the markup should appear on the page, in the same order.
- Put only the instruction in the step text, without Step 1 labels.
- List real supplies and tools; do not pad the lists with keywords.
- If the guide is mainly a video, add VideoObject markup with key moments as well.
Common questions
Does HowTo schema still show rich results in Google?
Is HowTo markup worth adding to a tutorial page?
What is the difference between supply and tool in HowTo schema?
How do I group HowTo steps into sections?
How does the HowTo schema generator write total time and cost?
Can I paste steps from my article into the HowTo form?
Should I use HowTo or Recipe schema for a cooking guide?
Can HowTo steps link to parts of my page?
More Schema tools
View allAutomatic Schema Markup Generator
Crawl your site, auto-detect + generate JSON-LD for every page
Schema Markup Generator
JSON-LD or microdata for 10 types, plus a validator
FAQ Schema Generator
Build FAQPage JSON-LD by hand, paste or URL import
Article Schema Generator
Build Article, BlogPosting or NewsArticle JSON-LD