Free HowTo Schema Generator
Generate HowTo JSON-LD structured data to display step-by-step instructions as rich results in Google Search. Help users find and follow your guides directly from search results.
What is HowTo Schema?
HowTo schema is a structured data type that marks up instructional content on your page. It tells search engines that your content provides step-by-step guidance for completing a specific task. When properly implemented, Google can display your instructions as an expandable rich result showing individual steps, estimated time, materials needed, and tools required.
The HowTo type is part of the schema.org vocabulary and is designed for any content that walks users through a process. This includes recipes, DIY tutorials, repair guides, software setup instructions, and any other sequential task. By structuring this content as HowTo markup, you make it immediately parseable by both search engines and AI assistants.
Why Use HowTo Schema? Benefits for SEO and AI Visibility
Adding HowTo structured data to your instructional pages unlocks several advantages:
- Step-by-step rich results: Google can show your individual steps directly in search results, giving your page massive visual presence.
- Google Assistant integration: HowTo markup enables voice assistants to read your steps aloud, capturing voice search traffic.
- AI system comprehension: AI models can parse your steps as discrete actions, making your content more likely to be cited in AI-generated answers.
- Increased trust signals: Showing time estimates and required materials in search results sets proper expectations and attracts qualified traffic.
- Image carousel potential: Steps with images can appear as a visual carousel in search results, drawing even more attention.
Required and Recommended Properties
Required Properties
@type: Must be "HowTo"name: The title of the how-to guidestep: An array of HowToStep objectsHowToStep.text: The instruction text for each step
Recommended Properties
totalTime: ISO 8601 duration (e.g., "PT30M" for 30 minutes)estimatedCost: Approximate cost to complete the tasksupply: Materials needed (array of HowToSupply)tool: Tools needed (array of HowToTool)image: Images for the overall guide or individual stepsstep.name: A short title for each stepstep.image: An image illustrating each step
JSON-LD Code Example for HowTo Schema
Here is a complete HowTo schema example for a simple tutorial:
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "How to Change a Flat Tire",
"description": "A step-by-step guide to safely changing a flat tire on the side of the road.",
"totalTime": "PT20M",
"estimatedCost": {
"@type": "MonetaryAmount",
"currency": "USD",
"value": "0"
},
"tool": [
{ "@type": "HowToTool", "name": "Lug wrench" },
{ "@type": "HowToTool", "name": "Car jack" }
],
"supply": [
{ "@type": "HowToSupply", "name": "Spare tire" }
],
"step": [
{
"@type": "HowToStep",
"name": "Find a safe location",
"text": "Pull over to a flat, stable surface away from traffic. Turn on your hazard lights."
},
{
"@type": "HowToStep",
"name": "Loosen the lug nuts",
"text": "Use the lug wrench to loosen each lug nut by turning counter-clockwise. Do not remove them completely yet."
},
{
"@type": "HowToStep",
"name": "Jack up the vehicle",
"text": "Place the jack under the vehicle frame near the flat tire. Raise the vehicle until the tire is about 6 inches off the ground."
},
{
"@type": "HowToStep",
"name": "Replace the tire",
"text": "Remove the lug nuts and pull off the flat tire. Mount the spare tire and hand-tighten the lug nuts."
},
{
"@type": "HowToStep",
"name": "Lower and tighten",
"text": "Lower the vehicle back to the ground. Tighten the lug nuts fully in a star pattern."
}
]
}Common Mistakes to Avoid
Using HowTo for non-instructional content
HowTo schema should only be applied to content that genuinely walks users through completing a task. Using it on informational articles or listicles violates guidelines.
Skipping the totalTime property
While not strictly required, omitting time estimates reduces your chances of earning rich results. Users want to know how long a task will take before they start.
Combining multiple tasks in one HowTo
Each HowTo should describe one distinct task. If your page covers multiple procedures, use separate HowTo objects for each one.
Vague step descriptions
Each step should be specific and actionable. Avoid generic instructions like "do the thing" or steps that combine multiple distinct actions into one.
Want to measure your overall AI search readiness? Use our free Agent readiness check to evaluate your site's AI optimization.
Frequently Asked Questions
What is the difference between HowTo and Recipe schema?
Recipe schema is a specialized subtype of HowTo designed specifically for cooking instructions. It includes additional properties like nutrition info, cook time, and ingredients. Use Recipe for food content and HowTo for everything else.
How many steps should a HowTo schema have?
There is no minimum or maximum, but between 3 and 10 steps works best for rich result display. If your process requires more steps, consider grouping related steps into sections using HowToSection.
Can I include images in HowTo schema steps?
Yes, and you should. Adding an image to each step significantly increases your chances of earning a visual carousel rich result. Each step image should clearly illustrate that particular instruction.
Does HowTo schema work for software tutorials?
Absolutely. HowTo schema works perfectly for software setup guides, configuration tutorials, and any digital process. Include screenshots as step images to maximize your rich result potential.