HowTo Schema Markup Generator — Free JSON-LD Builder

HowTo schema is the structured data behind step-by-step search results — the kind that take up huge real estate in Google with numbered cards, images, and time estimates. If you publish tutorials, fix-it guides, or any "how to do X" content, this is the schema type that gets you into those rich results. Our free generator builds the JSON-LD with all the steps, images, tools, and time fields Google supports.

What HowTo Schema Does in Search Results

HowTo schema lets Google show your tutorial as a stacked list of steps directly in search results — usually with an image for each step, the step title, and sometimes the total time required. On mobile, this can take up the entire first screen of results, pushing every other listing below the fold.

Google has limited HowTo rich results in some categories (it pulled them from food recipe results in favor of Recipe schema), but they're still active for technical, DIY, repair, and software tutorials. Even when the rich result doesn't appear, the schema feeds AI search assistants and helps Google understand the content structure.

If your blog publishes tutorials and you're not using HowTo schema, you're leaving rich results — and the click-through rates that come with them — on the table.

When HowTo Schema Is the Right Type (and When It's Not)

HowTo is for step-by-step instructions where the steps must be performed in order. Examples that work:

• How to install a ceiling fan
• How to bake bread from scratch
• How to set up a WordPress site
• How to change a tire
• How to fix a clogged drain

Examples that don't fit:

• "How to choose the best laptop" — that's a buying guide, not a procedure (use Article)
• "How recursion works" — that's an explainer (use Article)
• Recipes — Google moved these to Recipe schema specifically

If your content has clear, sequential steps with a definite end state, HowTo is right. If it's exploratory, comparative, or conceptual, use Article schema instead.

Required and Recommended Fields

Required: name (the tutorial title) and at least one HowToStep with a name and text.

Recommended:

• image — a hero image of the finished result
• totalTime — in ISO 8601 duration format (PT30M for 30 minutes, PT2H for 2 hours)
• estimatedCost — with a value and currency
• tool — an array of tools needed (each with a name)
• supply — an array of materials/supplies (each with a name)
• step image — image for each individual step (massively boosts how the rich result looks)

The generator builds all of these. Add as many steps as your tutorial has — there's no upper limit, but most tutorials work best with 5-12 steps. More than 12 and you should consider splitting into multiple tutorials.

Sell Custom Apparel — We Handle Printing & Free Shipping

The ISO 8601 Time Format (Don't Skip This)

HowTo schema uses ISO 8601 duration format for totalTime, which trips up many people. The format starts with "PT" then numbers and unit letters:

• PT30M = 30 minutes
• PT1H = 1 hour
• PT2H30M = 2 hours 30 minutes
• PT15M = 15 minutes
• P1DT2H = 1 day 2 hours (rarely needed for tutorials)

Don't write "30 minutes" — Google will reject it. The generator handles the conversion automatically: type 30 in the minutes field, the JSON output writes "PT30M".

Why Step Images Matter (and How to Add Them)

HowTo rich results look dramatically better with a unique image for each step. Without step images, Google may show only one hero image. With them, the rich result can show a horizontal carousel where users swipe through the steps visually — and that's when click-through rates spike.

For each step in the generator, fill in the imageUrl field with a direct URL to that step's image. The image should:

• Show what the step actually looks like (not stock photos)
• Be at least 1200px on the longest side
• Be hosted on your own domain (Google can crawl it)
• Have alt text on the page if the image is also visible to readers

The schema and the on-page content should match. If you have step images in the schema but the page only has text, Google may flag it as inconsistent.

Validating HowTo Schema and Tracking in Search Console

Always run new HowTo pages through both the Schema Markup Validator and Google's Rich Results Test before publishing. Common errors:

• Missing image on a HowToStep (warning, not error, but reduces rich result quality)
• totalTime in the wrong format (rejected outright)
• Steps without text (rejected)
• HTML inside step text instead of plain text or schema-allowed properties

Once published, watch the HowTo report in Search Console (under Enhancements). It tracks every page with HowTo schema and reports impressions, clicks, and errors. If you see impressions but no clicks, your titles or images probably need work. If you see errors, fix them within a week — Google will eventually stop showing rich results for sites with consistent errors.

If you're publishing tutorials regularly, also check our Article schema guide — pair Article + HowTo on long-form tutorial posts for the strongest signal.

Frequently Asked Questions

Does HowTo schema still work in 2026?

Yes for most categories — DIY, repair, software, technical, fitness, beauty. Google removed HowTo rich results from food recipes in favor of Recipe schema, but everywhere else they're still active. Even when rich results don't show, the schema helps with AI search visibility.

How many steps should a HowTo have?

Five to twelve is the sweet spot. Fewer than five and the tutorial is too thin to deserve a rich result. More than twelve and you should consider breaking it into multiple tutorials or making it a video. Each step should be substantive but not overwhelming.

Can HowTo schema include videos?

Yes. Add a video field to a HowToStep using VideoObject schema, with the video URL, thumbnail, and description. Google can use this to show video previews in the rich result. This works especially well for technical and DIY tutorials.

What's the difference between HowTo and Article schema?

HowTo is for procedural content with sequential steps. Article is for narrative content like blog posts, opinion pieces, or guides without strict steps. A long-form tutorial post can use both — Article as the page-level schema and HowTo as nested or linked content for the actual procedure.

Why isn't my HowTo rich result showing in Google?

Check four things: schema validates without errors, the steps and images on the page match the schema, the page has decent search ranking already (rich results require basic relevance), and HowTo rich results are still active in your category. If all four check out, give it 2-4 weeks for Google to start showing them.

Do step-by-step recipes use HowTo schema?

No, recipes use Recipe schema specifically. Recipe inherits from CreativeWork and has its own properties for ingredients, cook time, nutrition, and yield. Google moved recipe rich results entirely to Recipe schema in 2021. Use HowTo for non-food procedural content.