Skip to content

HowTo Schema Generator

Create HowTo JSON-LD structured data with steps, tools, and supplies

Capturing How-To Search Traffic with Structured Data

How-to queries represent a massive share of search traffic — people constantly search for instructions on how to do things. Our HowTo schema generator creates valid JSON-LD markup that enables your step-by-step guides to appear as interactive rich results in Google Search, with expandable steps, time estimates, and material lists.

How HowTo Rich Results Display

Google displays HowTo rich results as expandable step-by-step cards directly in search results. Users can preview each step without visiting your page, including step images if provided. This interactive format takes up significant search real estate and provides immediate value, encouraging users to click through for the complete guide.

Writing Effective Steps

Each HowToStep should describe a single, clear action. Start with an action verb, be specific about quantities and measurements, and include warnings or tips where relevant. Steps should be self-contained enough to be understood when read individually — Google may display them one at a time in voice responses or in the rich result expansion.

Tools and Supplies

The HowToTool and HowToSupply properties let you list what users need before starting. Tools are reusable items (hammer, screwdriver, software), while supplies are consumable materials (nails, paint, tape). Listing these upfront helps users assess whether they have everything needed, reducing abandonment and improving the user experience.

Cost and Time Estimates

Including totalTime and estimatedCost helps users decide whether a task is worth undertaking. The time estimate uses ISO 8601 duration format and the cost uses MonetaryAmount with currency. These details can appear in how-to structured data rich results, giving users practical information at a glance before committing to the full guide.

Content Eligibility Guidelines

HowTo schema is for instructional content where a task is completed by following steps. It should not be used for recipes (use Recipe schema instead), product instructions, or content that is not genuinely instructional. Each step must be visible on the page — do not include steps in the schema that users cannot see. Misleading or incomplete instructions violate Google's guidelines.

$ faq

What is HowTo schema markup?
HowTo schema markup is structured data that describes step-by-step instructions for completing a task. It includes steps, tools, supplies, time estimates, and costs. Google uses this data to display how-to rich results with expandable steps directly in search results, and also powers Google Assistant voice-guided instructions.
How is HowTo different from Recipe schema?
Recipe schema is specifically for food preparation with cooking-specific properties like ingredients, cook time, and nutrition. HowTo is for any non-recipe instructional content — DIY projects, repairs, crafts, software tutorials, and other step-by-step guides. Use Recipe for cooking, HowTo for everything else.
What fields are required for HowTo rich results?
Google requires the name and at least two HowToStep items with text content. For richer results, include totalTime (ISO 8601 duration), estimatedCost, supply and tool lists, and images for individual steps. Steps should be clear and actionable, and each step must represent a single action.
Can I include images for each step?
Yes, adding images to individual HowToStep items significantly improves the visual rich result. Google may display step images in a carousel format, making your how-to guide more engaging. Each image should clearly show the result or action of that specific step.
How should I format the estimated cost?
Use the MonetaryAmount type with value and currency properties. For example, a value of 25 with currency USD means the task costs about $25 to complete. This helps users assess whether the project fits their budget before starting. Include all materials and supplies in the estimate.
Does HowTo schema work with Google Assistant?
Yes, Google Assistant can read HowTo schema steps aloud on smart speakers and smart displays, guiding users through tasks hands-free. This makes clear, concise step text especially important — each step should be understandable when read aloud without visual context from the page.