How-To Schema Generator
Create step-by-step guide markup for tutorials, recipes, DIY projects, and instructions. Get rich cards with images, time estimates, and materials list in Google Search.
How-To schema displays step-by-step instructions in rich cards. Each step should have a name and detailed text. Add images to steps for visual guides. Learn more about How-To markup →
Important: Each step must have detailed text instructions. Steps with only names won’t qualify for rich results. Add step images when possible for visual guides.
How to Add How-To Schema
Get your step-by-step guides featured as rich cards in Google Search with images, time estimates, and materials lists.
Where to Place the Code
Add the JSON-LD code to the <head> section of your how-to guide page. The schema should match the visible content on the page exactly.
- Place in <head> section of the article
- Ensure steps match visible content
- Use the same images in schema and on page
- Each step should have substantial text (not just titles)
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "How to...",
"step": [
{
"@type": "HowToStep",
"position": 1,
"name": "Step Name",
"text": "Detailed instructions..."
}
]
}
</script>
Validation Checklist
Minimum 2 Steps
How-To must have at least 2 steps to qualify for rich results
Detailed Instructions
Each step must have substantial text content, not just a title
Valid Time Format
Use ISO 8601 duration: PT30M (30 minutes), PT2H (2 hours)
Test in Rich Results
Validate markup before publishing to catch errors early
Perfect for These Content Types
How-To schema works best for instructional content with clear steps. Google displays these as rich cards with expandable steps, images, and estimated completion time.
Recipes
Cooking instructions with ingredients and prep steps
DIY Projects
Home repairs, crafts, and building tutorials
Tech Tutorials
Software guides, troubleshooting, and setup help
Creative Guides
Art techniques, design tutorials, and creative processes
Important: How-To schema is for procedural content only. Do not use for recipes (use Recipe schema), general articles, or content without clear sequential steps.
Best Practices for How-To
Follow these guidelines to maximize visibility and ensure your how-to guides appear in rich results with full feature support.
🖼️ Add Step Images
Each step can have its own image. These appear in the rich card carousel and improve engagement significantly.
⏱️ Include Time Estimates
Total time helps users decide if they can complete the task. Use realistic estimates for better user satisfaction.
📋 List Materials
Supplies and tools help users prepare before starting. This reduces abandonment and improves completion rates.