Mirrors your title, description, tools, supplies, and ordered steps. Real Google layouts vary by device and experiment.
How-to title
Add step names or text to preview instructions.
Embed in <script type="application/ld+json">. Markup must match visible content on the page. Eligibility for rich results depends on Google policies and page quality.
HowTo schema is structured data that describes a process: a task broken into ordered steps, optionally with tools, supplies, total time, and estimated cost. When you publish JSON-LD with @type HowTo, you give search engines a machine-readable outline of instructions that should already appear visibly on the page for human readers. Google has historically used HowTo data for rich treatments such as step carousels and expanded instructional layouts on mobile; policies and eligibility evolve, so treat markup as a faithful description of your content rather than a guarantee of any specific SERP layout.
Tutorial sites, DIY blogs, recipe-style articles that are written as procedures (even when you also use Recipe schema elsewhere), software documentation, and home-improvement publishers all benefit when structured data matches a clear narrative: title, summary, ordered steps, and optional media. HowTo fits any domain where someone asks “how do I…” and your page answers with a sequence. Unlike FAQPage, which encodes independent question-and-answer pairs, HowTo encodes a single coherent procedure. Unlike Recipe, which targets ingredients, yield, and nutrition with a specialized type, HowTo is the general-purpose instruction format for non-food or hybrid guides.
SynthQuery’s How-To Schema Generator runs entirely in your browser. You build unlimited steps, drag to reorder tools, supplies, and steps, set duration with an hours-and-minutes helper that outputs ISO 8601 (for example PT1H30M), add estimated cost with currency, load starter templates for recipe-style, DIY, or software tutorials, and validate against common Google HowTo expectations before you copy or download JSON-LD. Your draft stays on your device during editing—ideal for pre-launch pages and internal documentation.
What this tool does
Unlimited steps mean long procedures—multi-day renovations, detailed software setup, or editorial workflows—can be modeled without artificial caps. Drag-and-drop applies separately to tools, supplies, and steps so you can match the same order readers see in your article layout without retyping JSON. Each step is auto-numbered in the visual preview and receives an explicit position property in JSON-LD for consumers that read ordered lists.
The tools and supplies sections map to Schema.org HowToTool and HowToSupply. You can omit either section entirely when irrelevant, or mix both for crafts and hardware projects. Optional URLs support affiliate or documentation links where policy allows; optional images help when each tool or material has a canonical photo hosted on your CDN.
The duration helper removes mental math: enter human-friendly hours and minutes and the generator emits valid ISO 8601 for totalTime. The estimated cost fields produce a MonetaryAmount with currency and value suitable for many guides where readers budget time and money together.
Per-step image and URL fields let you tie instructions to screenshots, diagrams, or deep links—useful for software walkthroughs and assembly diagrams. Template presets (recipe-style, DIY project, software tutorial) preload realistic examples you can edit in seconds, which accelerates onboarding for teams new to structured data.
Live JSON-LD preview uses syntax highlighting so brace and comma errors stand out immediately. Validation encodes practical Google documentation expectations—especially the need for multiple substantive steps—while explaining that eligibility for rich results still depends on site quality and policy. The illustrative visual preview shows how your title, description, tools, supplies, and ordered steps might read as a single instructional block, complementing the raw JSON and Rich Results Test.
Technical details
Schema.org defines HowTo as a CreativeWork subtype with properties such as name, description, image, totalTime, estimatedCost, tool, supply, and step. Each step is typically a HowToStep with name, text, optional url, optional image, and position when order matters. HowToSection exists to group steps under headings for very long guides; this generator focuses on a flat step list, which is valid and common for many articles.
ISO 8601 durations prefix length with P (period) and separate time with T, hence PT1H30M for one hour thirty minutes, PT45M for forty-five minutes, or P1DT2H for one day and two hours. Google’s documentation references these formats for totalTime. estimatedCost uses MonetaryAmount with currency (ISO 4217) and value.
HowTo rich results have changed over time; Google may show step-based layouts on some surfaces and not others, and eligibility can depend on site category and quality. Video can complement HowTo: you may embed VideoObject elsewhere on the page or reference video in your content, but keep HowTo text aligned with what users can follow without watching. Always place JSON-LD in the page head or body as a single graph or block consistent with your CMS; avoid duplicating conflicting HowTo objects on the same URL.
Use cases
DIY and home-improvement blogs publish guides that list tools, materials, and a strict sequence: measure, cut, fasten, finish. HowTo schema mirrors that narrative so search systems can connect entities (stud finder, torque wrench) with the steps where they matter. Cooking sites that present narrative recipes without full Recipe fields can still describe a procedural article as HowTo when the page is truly instructional—though use Recipe when the page is primarily a food recipe per Google’s recipe guidelines.
Software and SaaS documentation pages that walk through installation, environment setup, or integration often map cleanly to HowToStep text with screenshots as image URLs. Internal IT runbooks can reuse the same pattern for JSON-LD on public help centers. Craft and maker tutorials benefit from supplies lists (vinyl sheets, heat press settings) and tool lists (weeding hook, squeegee) separated from step prose.
Home services and agencies can structure “how we install” or “how to prepare for your appointment” pages when those instructions are visible to customers. Education publishers can encode lab procedures or assignment walkthroughs when each step is shown on-page. In every case, the visible HTML should contain the same information as the structured data; the generator reduces syntax mistakes, but editorial accuracy remains your responsibility.
How SynthQuery compares
Hand-coding JSON-LD is error-prone: trailing commas, mismatched braces, wrong @type strings, and forgotten required fields waste engineering time. Spreadsheet templates drift from on-page copy. Generic LLM output may hallucinate properties or mix Recipe and HowTo incorrectly. SynthQuery’s generator keeps you inside Schema.org’s HowTo, HowToStep, HowToTool, and HowToSupply shapes while providing a visual builder: drag-and-drop ordering, duration and cost helpers, templates, highlighted preview, and validation tuned to Google’s HowTo documentation.
Because drafting runs client-side in the browser, you can iterate on proprietary procedures before publication without uploading content to an unknown API. Pair the generator with our FAQ, Product, Review, and Breadcrumb tools when a single URL combines multiple entity types—just ensure one coherent visible story and avoid spammy markup stacks that do not reflect user-visible content.
Aspect
SynthQuery
Typical alternatives
Authoring
Form-driven HowTo with templates and per-step media fields.
Raw JSON editors or static snippets disconnected from page order.
Reordering
Drag-and-drop for tools, supplies, and steps.
Manual array editing or regenerate from scratch after edits.
Duration
Hours/minutes helper emits ISO 8601 totalTime.
Manual PT string entry with frequent typos.
Validation
Checks name, step count, text, URLs, and cost fields.
Syntax-only validation without Google-oriented hints.
Cost
Free in-browser generator with copy and download.
Paid SEO suites or one-off agency deliverables.
Privacy
Client-side editing for the interactive form; no server round-trip for drafting.
Hosted tools that post your content to remote APIs.
How to use this tool effectively
1) Enter the how-to title in the name field. This should match the main headline users see and describe the outcome (“Install a smart thermostat”, “Reset your API keys”, “Build a raised garden bed”).
2) Write a short description that summarizes scope, prerequisites, or what “done” looks like. Google and readers both use this context to judge relevance.
3) Under Tools, click “Add tool” for equipment readers need (drill, software IDE, browser). Under Supplies, click “Add supply” for consumables or materials (screws, flour, API token). Optional URL and image fields accept absolute https URLs when you want to link to product pages or representative images.
4) Build steps with “Add step” as many times as you need. Each step supports a short name (heading), full instructional text, optional image URL, and optional link (for example deep-linking to a vendor download). Drag the handle on any step, tool, or supply card to reorder; JSON-LD order follows your sort order, and steps receive sequential position values.
5) Set total time using the hours and minutes inputs. The tool converts automatically to Schema.org’s ISO 8601 duration format (such as PT45M or PT2H). Leave both at zero if duration does not apply.
6) If cost matters, enter a numeric value and a three-letter ISO 4217 currency code (USD, EUR, GBP). The generator emits a MonetaryAmount object under estimatedCost.
7) Watch the validation panel: you need a non-empty name and at least two steps with instructional text for typical Google HowTo guidance. Fix warnings about missing descriptions, absolute URLs, or currency format before production.
8) Use “Copy JSON-LD” or “Download” to hand off to your CMS or static site. Embed once per page inside a script tag with type application/ld+json. Run Google’s Rich Results Test on a public or staging URL to confirm parsing in full page context.
9) After launch, keep markup synchronized with visible copy whenever you edit steps, images, or timing. Structured data that contradicts the DOM can trigger manual actions or loss of enhancements.
Full catalog at https://synthquery.com/tools — AI content intelligence and SEO utilities.
Frequently asked questions
How-To schema usually refers to Schema.org type HowTo expressed as JSON-LD (or compatible formats). It describes a procedure: a name, optional description, optional total time and estimated cost, optional lists of tools and supplies, and an ordered series of HowToStep items with instructional text. Search engines use it to understand that your page teaches a task. It is not a substitute for clear writing; it encodes what readers already see in your headings, paragraphs, and images.
Google has shown various HowTo treatments over time, including mobile layouts that highlight multiple steps from a page. What you see in live search depends on query, language, device, site quality, and ongoing experiments. Valid markup in the Rich Results Test means Google can parse your data—not that a specific visual enhancement will always appear. Monitor Search Console performance and treat any rich layout as a potential bonus, not a contract.
Recipe is specialized for food content: ingredients, yield, cook time, nutrition, and cuisine fields map to how people cook. HowTo is the general instruction type for arbitrary tasks—software setup, crafts, repairs. If the page is primarily a food recipe with ingredient lists and cooking instructions, Google expects Recipe markup. If the page is a broader procedural guide that is not best modeled as Recipe, HowTo may fit better. Choose the type that matches the primary user intent and visible content; do not double-stack conflicting types for the same instructions.
Include every major step a reader must perform in the same order shown on the page. Google’s documentation has emphasized multiple substantive steps for HowTo; very short or boilerplate steps may be ignored or seen as low quality. Avoid splitting one logical action into many tiny steps solely to inflate count, and avoid cramming unrelated tasks into one HowTo. If you have optional branches, consider separate pages or clearly labeled sections with matching visible text.
Yes. HowToStep supports an image property, typically as an absolute URL to a representative image for that step—screenshots, photos, or diagrams hosted on your site or CDN. Images should illustrate the instruction users see in that step. Use https URLs, reasonable file sizes, and alt text in the HTML for accessibility. The generator includes optional image fields per step so you can align JSON-LD with your figure elements.
Durations describe a length of time without tying to a calendar date. Schema.org totalTime uses ISO 8601: a P starts the period; T separates date from time parts. Examples: PT30M (30 minutes), PT1H (one hour), PT1H30M (one hour thirty minutes), P1D (one day), P1DT12H (one day and twelve hours). SynthQuery converts hours and minutes you enter into a valid PT string for JSON-LD so you rarely need to memorize the syntax.
HowTo and video can coexist on the same page. Many tutorials embed a VideoObject or host video in iframes while the article text walks through the same steps. Ensure the HowTo text still makes sense for users who cannot watch video. If you add Video structured data, follow Google’s video guidelines separately. The relationship is complementary: video engages visually; HowTo encodes the textual procedure crawlers and assistants can parse.
Embed JSON-LD in a script element with type application/ld+json, usually in the head or near the end of the body, consistent with your platform’s pattern. The important rules are: one coherent graph per page (avoid contradictory duplicates), markup must reflect visible content, and avoid hiding instructions in JSON that are not shown to users. After deployment, validate the public URL in Google’s Rich Results Test to catch CMS injections or caching issues.
Voice assistants and other Google surfaces may consume structured data when answering how-to queries, but behavior varies by device, locale, and content rights. Publishing accurate HowTo JSON-LD improves machine understanding generally; it does not guarantee a specific Assistant response. Keep steps concise for spoken contexts while maintaining enough detail on the page for readers who learn visually.
HowToStep represents a single instruction in the sequence—typically name, text, optional url and image. HowToSection groups multiple steps under a section name, useful for very long guides (“Prepare materials”, “Assembly”, “Finishing”). This generator outputs a flat list of HowToStep items, which is valid for many articles. If you need sections, extend the JSON manually or refactor content into logical pages, ensuring the structure still matches what users see.