b2KIT

How-To Schema Builder

Create HowTo schema markup with steps, tools, supplies, and images. Generate JSON-LD for step-by-step rich results.

Tested tool guide Tested browser tools Checked August 16, 2026

What How-To Schema Builder does and how it behaves

HowTo markup separates a procedure into an overall task, ordered actions, required tools, consumed supplies, and image references. How-To Schema Builder collects those parts and produces JSON-LD that labels them as a Schema.org HowTo rather than leaving their meaning buried in prose. It is intended for a page that already contains the same tutorial. The common mistake is treating generated markup as either the visible instructions or a promise of a search rich result; it is neither. Review the step order and every URL before publishing.

How the result is produced

1

Procedure structure

The procedure is represented as a HowTo entity, while individual instructions are represented as ordered steps. Tool and supply entries describe what the complete task requires instead of being left as unlabeled text. Image entries associate relevant visuals with the procedure or its steps. This structure lets consumers distinguish preparation information from the actions a reader must perform.

2

JSON-LD result

The generated data identifies the Schema.org context and HowTo type, then assigns the entered values to corresponding properties. Steps retain their meaningful sequence because changing their order can change the procedure. The resulting JSON-LD is machine-readable metadata for inclusion with the matching page. It does not create the page's headings, numbered instructions, photographs, or other visible tutorial content.

Good uses

  • Mark up a published home-repair guide that already shows its tools, materials, photographs, and numbered instructions.
  • Describe a craft tutorial whose supply list and step photographs need to be distinguished from the ordered actions.
  • Regenerate HowTo JSON-LD after revising the wording, images, required equipment, or sequence of an existing procedure.

Limits and checks

  • A syntactically valid HowTo block can still misrepresent the page. Every generated step, tool, supply, and image should correspond to content users can find in the visible tutorial.
  • The builder cannot determine whether an entered image address is public, durable, or associated with the intended step. Test each reference on the published site.
  • Structured data does not guarantee indexing, validation by every consumer, or a particular search presentation. Search services independently decide whether they recognize and display HowTo information.

Common questions

Will this markup make my tutorial appear as a rich result?

No. The builder can produce a structured description of the tutorial, but it cannot guarantee that a search engine will index the page, accept the markup, or display a special result. Eligibility and presentation depend on the consuming service and may change. The markup should therefore be accurate even when no enhanced search display appears.

Does adding an image put the image inside the JSON-LD?

No. A HowTo image value identifies an existing image, commonly through a URL or an ImageObject containing a URL; it does not contain the image file itself. Entering the reference in this browser tool does not upload the image. The referenced file still needs to be available at the address used by the published page.

References and verification

The behavioral notes were checked against the browser implementation. Standards and primary references below define the relevant format, formula, or platform behavior.

Related Tools