How to fix missing schema howto on Drupal

Add HowTo structured data (JSON-LD) to any page that walks customers through a multi-step process, so Google can display your instructions as rich results in search.

Steps for Drupal

  1. Install the 'Schema.org Metatag' module or 'Metatag' module with the JSON-LD submodule from drupal.org.
  2. Configure schema mappings for the relevant content type (e.g. 'How-to Guide') under Configuration › Search and Metadata › Metatag.
  3. For HowTo, you may need a custom module or a preprocess hook in your theme's .theme file to build the JSON-LD array and attach it via #attached['html_head'] on the relevant node type.
  4. BreadcrumbList is handled by the 'Simple XML Sitemap' or Metatag modules, or via a custom hook_preprocess_page().
  5. Validate with Google's Rich Results Test.
Official Drupal documentation ↗

What is missing schema howto?

HowTo structured data is a special block of machine-readable code — written in a format called JSON-LD — that you add to a page to tell Google "this page contains step-by-step instructions." It explicitly labels each step, tool, supply, and time estimate so search engines understand the content precisely. When Google recognises it, your page becomes eligible for rich results: visually expanded listings in search that show the actual steps directly below your link, before a user even clicks. Without this markup, Google has to guess whether your page is a how-to, and you lose the chance for that premium search placement.

Pages with HowTo rich results occupy significantly more visual real estate in search results — often showing 3–5 collapsible steps right on the results page — which dramatically increases click-through rates compared to a plain blue link. This is especially valuable for "Answer Engine Optimization" (AEO): AI-powered search features (Google AI Overviews, voice search, featured snippets) pull structured, step-based content preferentially when deciding what to surface. Missing this markup means a competitor who has it will own that SERP space, capturing organic traffic that should be yours. For ecommerce stores, how-to content (how to assemble, how to use, how to style a product) directly supports purchase decisions and reduces returns — both of which have measurable revenue impact.

See the complete Missing schema howto guide for every platform and the full background.

Not sure if your Drupal store has this?

Run a free SEOLZ scan — we’ll find missing schema howto and every other issue across your whole site.

Scan my site free

Fix missing schema howto on another platform