1001Ferramentas
🪜SEO

HowTo Rich Snippet Builder

Build a basic HowTo JSON-LD schema describing a single-step procedure.


  

Marking up a tutorial with HowTo schema

You wrote a step-by-step guide and want machines to know which part is the tutorial title and which parts are individual instructions. Schema.org HowTo covers exactly that, but the nested shape — root object, array of steps, each step with its own type — is easy to mistype, and one misplaced bracket invalidates the whole block.

There are two fields: tutorial title and one step of text. The output is a HowTo object with name filled in and a step array holding a single HowToStep, all wrapped in a JSON-LD script tag. The vocabulary is worth knowing: name at the top level is the tutorial title, while text inside the step is the instruction. HowToStep also accepts name, url and image, none of which this version emits. For a seven-step guide, duplicate the HowToStep object inside the array.

The honest caveat: Google stopped showing HowTo rich results in search in September 2023. The markup is still valid schema and remains useful for internal search, feeds and other aggregators, but do not expect a step carousel in the SERP. If your content is a cooking recipe, the right type is Recipe rather than HowTo. Generation happens entirely in your browser, with no data sent anywhere.

Frequently asked questions

Is HowTo markup still worth adding?
Not for direct SERP gains. It makes sense when something else reads your schema: internal search, an assistant, a partner feed, or your own content pipeline.
How do I add the remaining steps?
Duplicate the object with @type HowToStep inside the step array, comma separated. Array order is the order of the tutorial.
Can I use HowTo for a cake recipe?
Better not. Recipes have their own type, Recipe, with recipeIngredient and recipeInstructions — and that one still produces a rich result.

Related Tools