Rich Results

HowTo Schema Markup

Generate HowTo JSON-LD for step-by-step guide rich results — Google displays numbered steps directly in search for eligible how-to content.

Rich result type
Step-by-step rich results
Google documentation →

What valid HowTo JSON-LD looks like

A complete, validator-ready example — drop it in your <head>, swap the values for yours, and you're done.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "How to Change a Tire",
  "description": "A step-by-step guide to changing a flat tire safely.",
  "totalTime": "PT30M",
  "step": [
    {
      "@type": "HowToStep",
      "position": 1,
      "name": "Loosen the lug nuts",
      "text": "Use the lug wrench to loosen each nut slightly before jacking up the car."
    },
    {
      "@type": "HowToStep",
      "position": 2,
      "name": "Jack up the vehicle",
      "text": "Place the jack under the vehicle frame and raise it until the tire clears the ground."
    },
    {
      "@type": "HowToStep",
      "position": 3,
      "name": "Remove the flat tire",
      "text": "Remove the lug nuts completely and pull the flat tire off the hub."
    }
  ]
}
</script>
Want more than HowTo validation?

Run a full CrispAudit on your URL

Schema, cookies (GDPR/CCPA), accessibility, SEO — plus AI-generated fixes populated with your page's actual content. Free.

Run full audit →

Required fields

  • name
  • step[].name
  • step[].text

Recommended fields

  • totalTime
  • estimatedCost
  • image
  • tool
  • supply

Common HowTo schema errors

  • ✗step.text is empty or duplicates step.name
  • ✗totalTime not in ISO 8601 duration format (PT30M)
  • ✗Missing image on steps for image-rich results
  • ✗Using HowTo for non-instructional content

Generate HowTo schema

Fill in the fields below to generate valid JSON-LD you can paste directly into your page.

HowTo schema — frequently asked questions

What content qualifies for HowTo rich results?

Only pages that describe how to complete a task step-by-step qualify. Recipe, tutorial, repair guides, and DIY content are ideal. Marketing or promotional content will not be eligible.

How do I format totalTime?

Use ISO 8601 duration format: PT30M for 30 minutes, PT1H for 1 hour, PT1H30M for 1 hour 30 minutes.

Can I use HowTo with Recipe schema?

No — use Recipe schema for cooking content instead, which has its own rich result type with better visibility in search.

Other schema types

E-commerceProductProduct snippets, Google ShoppingContentArticleTop Stories, Article rich resultsRich ResultsFAQPageFAQ dropdowns in SERPBrandingOrganizationKnowledge Panel, logo in searchLocal SEOLocalBusinessLocal Knowledge Panel, Google MapsNavigationBreadcrumbListBreadcrumb trails in SERP

Audit your full schema coverage

CrispAudit checks all schema types at once — get a complete score and fix-it report for any URL.

Run free audit →