How-To Schema Markup Generator
HowTo schema markup is one of the most engaging structured data types, ideal for tutorials, step-by-step guides, DIY articles, and instructional pages. When implemented correctly, it can trigger rich results with images, step labels, and even voice integration in Google Assistant.
Try an example
Fields
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "HowTo"
}
</script>How-To Schema Markup FAQ
HowTo schema markup is a type of structured data defined by Schema.org that helps search engines understand instructional content that teaches users how to do something - step by step.
When properly implemented, your guide becomes eligible for How-to rich results in Google Search, showing images, steps, tools, and materials directly in the results.
Adding HowTo schema markup helps you:
- Qualify for How-to rich results with step-by-step previews.
- Increase CTR and engagement through interactive search listings.
- Improve voice search visibility (Google Assistant often reads HowTo content).
- Help Google understand the logical structure of your content.
- Strengthen your E-E-A-T signals by showcasing expertise through detailed instruction.
If your page teaches users how to perform a task - from SEO guides to home repairs - HowTo schema makes it easier for Google (and people) to follow.
The key properties to include are:
- Title of the tutorial / guide
- A short description of what the tutorial covers
- Steps of your HowTo directions as an array including text, name and even image.
Additionally you can include:
- URL of a featured image
- Estimated duration (in ISO 8601 format)
- Materials needed
- Tools required
HowTo schema improves SEO by:
- Making your page eligible for rich, visual how-to results.
- Increasing click-through rate with visual step previews.
- Helping Google index your instructions more clearly.
- Improving voice search and Google Assistant compatibility.
- Reinforcing your expertise in a topic with structured, detailed content.
How-to rich results tend to dominate SERPs for practical, "how to..." searches - a high-intent and highly clickable search category.
- Steps not visible on-page: All steps in your JSON-LD must appear in your visible content.
- Missing or low-quality images: Use at least one clear image per step (min 800x600 px).
- Incorrect total time format: Use ISO 8601 duration (e.g.,
PT10M= 10 minutes,PT1H30M= 1.5 hours). - Omitting tools or materials when relevant: These properties help your content look richer and more helpful.
- Using HowTo schema for Q&A or articles: Reserve HowTo schema for instructional processes, not opinion or general info.
- Overly complex steps: Keep step text concise — each should describe a single actionable instruction.
- Missing main image: While optional, a main image significantly improves rich result eligibility.
Only if the article is instructional and structured as clear steps.
Otherwise, use Article or BlogPosting schema instead.
Yes. Use the totalTime and estimatedCost properties:
"totalTime": "PT30M",
"estimatedCost": {
"@type": "MonetaryAmount",
"currency": "USD",
"value": "0"
}This tells Google how long and how much it costs to complete your process.
Yes - especially for tutorials or guides.
Wrap your HowTo inside an Article schema, or include both separately on the same page (as long as each describes its respective content clearly).
Additional Resources
Official documentation and guides to help you get the most out of your schema markup.
Use our other schema markup generators
HowTo rich results without writing a line of JSON
Schema Pilot reads your step-by-step guides and generates complete HowTo markup with steps, tools, and supplies — automatically.