HowTo Schema for Guides: The Complete 2026 Guide

HowTo schema is a structured data vocabulary that describes step-by-step instructions for completing a task. When implemented on tutorial and guide pages, it enables rich results that display steps, images, tools, and time estimates directly in the search snippet. This guide covers the on-page application of HowTo schema for instructional content, distinguishing it from general content schema strategies covered elsewhere.

HowTo rich results transform a standard search snippet into an interactive step preview. Users can see the total time required, the number of steps, and sometimes an estimated cost before clicking. This pre-qualifies traffic and reduces bounce rates because visitors already know the scope of the tutorial. Google also surfaces HowTo markup in the "How-to" search feature on mobile devices.

Google's documentation confirms that HowTo schema is eligible for rich results when the page contains a clear set of instructions with at least one completed step. The schema is particularly effective for recipes, DIY guides, software tutorials, and assembly instructions.

The core properties for HowTo schema include:

• @type: Use HowTo.
• name: The title of the guide or tutorial.
• description: A summary of what the guide teaches.
• step: An array of HowToStep objects, each with a position and text.
• totalTime: The total duration in ISO 8601 format (e.g., PT30M for 30 minutes).
• tool: Optional. An array of HowToTool objects listing required tools.
• supply: Optional. An array of HowToSupply objects listing required materials.
• image: Optional. An image representing the completed result.

Below is a complete JSON-LD block for a how-to guide page. Place it inside a <script type="application/ld+json"> tag.

{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "How to Install a WordPress Plugin Manually",
  "description": "A step-by-step guide to manually installing a WordPress plugin via FTP or the WordPress admin dashboard.",
  "totalTime": "PT10M",
  "estimatedCost": {
    "@type": "MonetaryAmount",
    "currency": "USD",
    "value": "0"
  },
  "image": "https://example.com/images/wordpress-plugin-install.jpg",
  "step": [
    {
      "@type": "HowToStep",
      "position": 1,
      "name": "Download the plugin ZIP file",
      "text": "Download the plugin ZIP file from the developer's website or the WordPress plugin repository.",
      "image": "https://example.com/images/step1-download.jpg"
    },
    {
      "@type": "HowToStep",
      "position": 2,
      "name": "Upload via WordPress admin",
      "text": "Navigate to Plugins > Add New > Upload Plugin. Select the ZIP file and click Install Now.",
      "image": "https://example.com/images/step2-upload.jpg"
    },
    {
      "@type": "HowToStep",
      "position": 3,
      "name": "Activate the plugin",
      "text": "After installation completes, click Activate Plugin to enable it on your site.",
      "image": "https://example.com/images/step3-activate.jpg"
    }
  ],
  "tool": [
    {
      "@type": "HowToTool",
      "name": "WordPress admin access"
    }
  ]
}

Generate the HowTo schema dynamically from your CMS. If you use a tutorial plugin or custom post type, map the stored step data directly to the JSON-LD structure. Use the position property to ensure step ordering is explicit, especially if you render steps in a grid or non-linear layout.

Include totalTime whenever possible. Google uses this to display duration in the rich result. Use ISO 8601 format precisely: PT followed by hours (H) and minutes (M), e.g., PT1H30M for 90 minutes. Omit totalTime only if the duration is variable and cannot be estimated.

Validate every HowTo schema block with Google's Rich Results Test. Confirm that each HowToStep has both a position integer and a text string. Check that totalTime follows strict ISO 8601 syntax. Ensure the visible steps on the page correspond to the steps in the schema. Run a site-wide audit to identify guides that have step content but are missing HowTo schema markup.

1. Google Search Central. "HowTo structured data." https://developers.google.com/search/docs/appearance/structured-data/how-to
2. Schema.org. "HowTo type definition." https://schema.org/HowTo
3. Google Developers. "Rich results test." https://search.google.com/test/rich-results