LocalSEOTrack
Home/ Resources/ HowTo Schema Markup: Step-by-Step Implementation Guide

HowTo Schema Markup: Step-by-Step Implementation Guide

Published March 16, 2026

HowTo Schema Markup: Step-by-Step Implementation Guide

HowTo schema markup is structured data that tells search engines your page contains step-by-step instructions. When implemented correctly, it can earn your content an expanded rich result in Google showing each step directly in the search results — increasing visibility and click-through rates.

What Is HowTo Schema Markup?

HowTo schema is a schema.org type that describes a set of instructions for completing a task. It provides search engines with structured information about each step, required tools and supplies, estimated time, and cost. Google uses this data to display rich results with expandable step-by-step instructions directly in search.

Eligibility: HowTo rich results appear for instructional content only. Google requires that each step is a complete, standalone instruction — not just a heading or section title. Recipe content should use the Recipe schema instead.

How HowTo Rich Results Appear in Google

When Google processes valid HowTo markup, your search result can display:

  • Expandable steps shown directly below your search listing
  • Step images if you include image URLs for each step
  • Total time and estimated cost badges
  • Supplies and tools needed for the task

This expanded format takes up significantly more SERP real estate than a standard result, making it far more likely to attract clicks.

Required and Recommended Properties

The HowTo schema has both required and optional properties:

PropertyRequired?Description
nameYesTitle of the how-to (e.g., "How to Change a Tire")
stepYesArray of HowToStep objects with text instructions
step.textYesThe instruction text for each step
descriptionRecommendedBrief description of what the how-to accomplishes
totalTimeRecommendedISO 8601 duration (e.g., PT30M for 30 minutes)
estimatedCostOptionalCost to complete the task
supplyOptionalMaterials needed (HowToSupply objects)
toolOptionalTools needed (HowToTool objects)
step.imageOptionalImage URL illustrating the step

JSON-LD Implementation Example

Here is a complete HowTo schema example in JSON-LD format:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "How to Optimize Your Google Business Profile",
  "description": "Step-by-step guide to optimizing your GBP for local search.",
  "totalTime": "PT45M",
  "estimatedCost": {
    "@type": "MonetaryAmount",
    "currency": "USD",
    "value": "0"
  },
  "supply": [
    { "@type": "HowToSupply", "name": "Business logo (high resolution)" },
    { "@type": "HowToSupply", "name": "Business photos" }
  ],
  "tool": [
    { "@type": "HowToTool", "name": "Google Business Profile account" }
  ],
  "step": [
    {
      "@type": "HowToStep",
      "name": "Claim your listing",
      "text": "Go to business.google.com and claim or create your listing."
    },
    {
      "@type": "HowToStep",
      "name": "Complete all business information",
      "text": "Fill in name, address, phone, website, hours, and category."
    },
    {
      "@type": "HowToStep",
      "name": "Add photos and media",
      "text": "Upload logo, cover photo, and interior/exterior photos."
    }
  ]
}
</script>

HowTo vs FAQ Schema: When to Use Which

  • HowTo schema: Use when your content teaches someone how to complete a specific task with sequential steps. Example: "How to install a WordPress plugin."
  • FAQ schema: Use when your page answers multiple independent questions. Example: A FAQ page with questions about pricing, shipping, and returns.

You can use both on the same page if it contains both a step-by-step guide and a FAQ section — just implement them as separate JSON-LD blocks.

Testing Your HowTo Markup

Always validate your markup before deploying:

  1. Google Rich Results Test — Tests if your page is eligible for rich results
  2. Schema Markup Validator (validator.schema.org) — Validates against the full schema.org spec
  3. Google Search Console — Monitor the "Enhancements" report for HowTo issues after deployment

Best Practices

  • One HowTo per page: Don't mark up multiple how-to guides on a single page
  • Detailed steps: Each step should be a complete instruction, not a vague heading
  • Include images: Steps with images are more likely to get visual rich results
  • Accurate timing: Only include totalTime if you can estimate it realistically
  • Match visible content: Your schema must reflect what's actually visible on the page
Common mistake: Using HowTo schema for content that is not genuinely instructional. Google may ignore your markup or issue a manual action if the schema does not match the page content.

Related Tools

HowTo Schema Generator

Generate HowTo JSON-LD structured data

FAQ Schema Generator

Create FAQ Page structured data

FAQ Schema Validator

Test and validate schema markup

Local Business Schema

Generate LocalBusiness schema markup

Article Schema Generator

Create Article structured data