SEOLZ

Missing schema howto

Moderate effort

Found on 26% of audited stores.

Add HowTo and BreadcrumbList structured data (JSON-LD) to pages that contain step-by-step instructions so Google can display them as rich results and answer-engine snippets.

What it is

Structured data is hidden code — written in a format called JSON-LD — that you add to a web page to tell search engines exactly what the content means, not just what it says. HowTo schema marks up step-by-step instructional content (like "How to assemble your product" or "How to apply for a return") so Google can understand each step individually. BreadcrumbList schema tells Google the navigation path to the page (e.g. Home › Help › Returns), which shows up as a readable trail in search results. Neither type is visible to shoppers; it lives quietly in the page's code and speaks directly to search engines and AI answer tools.

Why it matters

Pages with valid HowTo structured data are eligible for rich results — expanded, step-by-step listings in Google Search that take up significantly more screen space than a plain blue link, driving higher click-through rates. They are also prime candidates for Google's AI Overviews and other answer-engine features that pull structured steps directly into zero-click answers, putting your brand in front of shoppers before they even visit a competitor. BreadcrumbList markup improves how your URL path is displayed in search results, which has been shown to increase trust and clicks. Missing these schema types means leaving visible, high-intent real estate on the search results page empty — and handing it to competitors who have implemented them.

How to fix it

  1. Identify every page on your store that contains step-by-step instructional content — assembly guides, how-to tutorials, care instructions, return processes, DIY project pages — as these qualify for HowTo schema.
  2. Write a JSON-LD block with @type: HowTo, including a descriptive 'name' (the task title), an optional 'description', and a 'step' array where each item is a HowToStep object with a 'text' property (and optionally a 'name' sub-heading and 'image').
  3. Add a second JSON-LD block (or combine in an @graph array) with @type: BreadcrumbList, listing each level of the page's navigation path as a ListItem with 'position', 'name', and 'item' (URL).
  4. Inject both JSON-LD blocks inside the <head> tag (preferred) or anywhere in the <body> of the relevant page — each block is wrapped in a <script type='application/ld+json'> tag.
  5. Validate both schema blocks using Google's Rich Results Test (search 'Rich Results Test') by pasting the page URL or the raw JSON-LD code; fix any errors or warnings reported.
  6. After publishing, monitor Google Search Console under Enhancements for HowTo and Breadcrumb reports to confirm Google has indexed and rendered the rich results correctly.
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "HowTo",
      "name": "How to [Task Name]",
      "description": "A brief description of what this guide helps the user accomplish.",
      "step": [
        {
          "@type": "HowToStep",
          "position": 1,
          "name": "Step 1 Heading",
          "text": "Detailed description of what to do in step 1."
        },
        {
          "@type": "HowToStep",
          "position": 2,
          "name": "Step 2 Heading",
          "text": "Detailed description of what to do in step 2."
        },
        {
          "@type": "HowToStep",
          "position": 3,
          "name": "Step 3 Heading",
          "text": "Detailed description of what to do in step 3."
        }
      ]
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Home",
          "item": "https://www.example.com/"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "Guides",
          "item": "https://www.example.com/guides/"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "name": "How to [Task Name]",
          "item": "https://www.example.com/guides/how-to-task-name/"
        }
      ]
    }
  ]
}

Fix it on your platform

Pick your platform for the exact steps.

How to fix missing schema howto on Shopify
  1. Go to Online Store › Themes › Actions › Edit Code.
  2. For a page template: open Templates › page.howto.liquid (create a new template if needed via 'Add a new template').
  3. Paste your <script type='application/ld+json'> block containing the HowTo and BreadcrumbList JSON-LD just before the closing </article> or </div> tag, or add it to the theme.liquid <head> section using Liquid conditionals (e.g. {% if template == 'page.howto' %}).
  4. Alternatively, install a structured data app (e.g. 'JSON-LD for SEO' or 'Schema Plus') from the Shopify App Store to generate and manage schema without touching code.
  5. Assign the custom 'page.howto' template to each instructional page via Online Store › Pages › select page › Theme template dropdown.
  6. Validate with Google's Rich Results Test.
Full Shopify guide →Official Shopify docs ↗
How to fix missing schema howto on Shopify Plus
  1. Same as Shopify — use Edit Code on the relevant theme. Shopify Plus merchants can additionally use Shopify Scripts or a Storefront API-powered headless layer to inject JSON-LD programmatically.
  2. For organisation-wide rollout, add the JSON-LD injection to the <head> section of theme.liquid inside a Liquid conditional targeting the page handle (e.g. {% if page.handle contains 'how-to' %}).
  3. Use a structured data management app from the Shopify App Store for a no-code approach.
  4. Validate with Google's Rich Results Test.
Full Shopify Plus guide →Official Shopify Plus docs ↗
How to fix missing schema howto on WooCommerce
  1. Install and activate a schema plugin such as 'Rank Math SEO', 'Yoast SEO' (with its Schema tab), or 'Schema & Structured Data for WP & AMP'.
  2. For Rank Math: edit the instructional page in WordPress, open the Rank Math sidebar › Schema › Add New Schema › select HowTo; fill in steps using the guided UI, which auto-generates the JSON-LD.
  3. For manual injection without a plugin: edit your child theme's functions.php and use wp_head action hook to echo a <script type='application/ld+json'> block conditionally (e.g. is_page('how-to-slug')).
  4. BreadcrumbList is automatically output by Rank Math and Yoast on all pages when breadcrumbs are enabled under their settings.
  5. Validate with Google's Rich Results Test.
Full WooCommerce guide →Official WooCommerce docs ↗
How to fix missing schema howto on BigCommerce
  1. Go to Storefront › My Themes › Advanced › Edit Theme Files (Stencil theme).
  2. Open the relevant template file, typically templates/pages/custom/page/[your-page].html or templates/pages/blog-post.html for instructional content.
  3. Paste the <script type='application/ld+json'> block (HowTo + BreadcrumbList) anywhere within that template file before </body>.
  4. Alternatively, add a Custom Script via Storefront › Script Manager: set location to 'Footer', select the specific page(s), and paste the JSON-LD wrapped in a <script type='application/ld+json'> tag.
  5. Validate with Google's Rich Results Test.
Full BigCommerce guide →Official BigCommerce docs ↗
How to fix missing schema howto on Wix
  1. Open the page in the Wix Editor and click Add Elements › Embed Code › Embed HTML (Custom Code block).
  2. Paste the full <script type='application/ld+json'>…</script> block into the HTML code box and position the element anywhere on the page (it is invisible to visitors).
  3. For site-wide injection: go to Settings › Custom Code (in the Wix dashboard) › Add Custom Code, paste the JSON-LD, set it to load in the <head>, and restrict it to 'Specific pages' — select your instructional pages.
  4. Note: Wix automatically generates basic BreadcrumbList schema for structured site navigation; verify it is present using the Rich Results Test before adding a duplicate.
  5. Validate with Google's Rich Results Test.
Full Wix guide →Official Wix docs ↗
How to fix missing schema howto on Wix Studio
  1. Open the relevant page in Wix Studio editor.
  2. Click the '+' (Add Elements) panel › Embed & Social › Custom Embed, and insert an HTML embed element.
  3. Paste your <script type='application/ld+json'> block into the embed; publish.
  4. Alternatively use the site-wide Custom Code panel (Settings › Custom Code) with page-specific targeting.
  5. Validate with Google's Rich Results Test.
Full Wix Studio guide →Official Wix Studio docs ↗
How to fix missing schema howto on Squarespace
  1. Go to Pages › select your instructional page › Edit.
  2. Add a Code Block (Insert Point › Code) anywhere on the page.
  3. Paste the full <script type='application/ld+json'>…</script> block; ensure 'Display Source' is unchecked so it doesn't show as visible text.
  4. For Squarespace 7.1 with Code Injection access (Business plan or higher): Settings › Advanced › Code Injection › paste into the Header or Footer field and wrap in Squarespace's {% raw %}…{% endraw %} tags if needed to avoid template parsing.
  5. Squarespace generates its own BreadcrumbList for blogs/shop categories — verify before duplicating.
  6. Validate with Google's Rich Results Test.
Full Squarespace guide →Official Squarespace docs ↗
How to fix missing schema howto on Webflow
  1. Open the page in the Webflow Designer.
  2. Click the Page Settings gear icon (top-right of the canvas) › Custom Code tab.
  3. Paste the <script type='application/ld+json'>…</script> block into the 'Inside <head> tag' or 'Before </body> tag' field for that specific page.
  4. For CMS Collection pages (e.g. a 'Guides' collection): open the Collection Template, go to Page Settings › Custom Code, and use Webflow CMS dynamic field bindings (e.g. {{Name}}, {{Steps}}) inside the JSON-LD to populate schema dynamically for each guide.
  5. Publish the site and validate with Google's Rich Results Test.
Full Webflow guide →Official Webflow docs ↗
How to fix missing schema howto on Adobe Commerce (Magento)
  1. For CMS pages: go to Content › Pages › select the instructional page › Edit › Content tab.
  2. In the page content (HTML editor / Page Builder), add an HTML element and paste the <script type='application/ld+json'>…</script> block.
  3. For a more robust, maintainable approach: create a custom module or use an existing structured data extension (e.g. from Magento Marketplace, search 'structured data schema') to manage JSON-LD output via layout XML or a Block class.
  4. To inject via layout XML: add a block of type Magento\Framework\View\Element\Text to the <head> section in your theme's cms_page_view_id_{page_identifier}.xml layout file, with the JSON-LD as the block's text content.
  5. BreadcrumbList can be added the same way or generated dynamically by a schema extension that reads Magento's built-in breadcrumb trail.
  6. Validate with Google's Rich Results Test.
Full Adobe Commerce (Magento) guide →Official Adobe Commerce (Magento) docs ↗
How to fix missing schema howto on WordPress.org
  1. Install Rank Math SEO or Yoast SEO (free tiers support HowTo schema).
  2. For Rank Math: edit the page, open Rank Math sidebar › Schema › Add Schema › HowTo; fill in each step via the UI — no code required.
  3. For manual control: in your child theme's functions.php add an action on wp_head to echo a <script type='application/ld+json'> block conditionally using is_page() or a custom page template check.
  4. Rank Math and Yoast both auto-output BreadcrumbList when breadcrumbs are enabled in their settings (Settings › Titles & Metas › Breadcrumbs for Yoast; Rank Math › General Settings › Breadcrumbs).
  5. Validate with Google's Rich Results Test.
Full WordPress.org guide →Official WordPress.org docs ↗
How to fix missing schema howto on 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.
Full Drupal guide →Official Drupal docs ↗
How to fix missing schema howto on PrestaShop
  1. Use a structured data module from the PrestaShop Marketplace (search 'JSON-LD schema') or add custom code.
  2. For manual injection: override the relevant CMS page template (cms.tpl or cms-category.tpl in your theme's /templates/cms/ folder) and add the <script type='application/ld+json'> block before </body>.
  3. Use a hook (hookDisplayHeader or hookDisplayFooter) in a custom module to inject JSON-LD only on designated CMS pages, checking the controller type with $this->context->controller->php_self == 'cms'.
  4. Validate with Google's Rich Results Test.
Full PrestaShop guide →Official PrestaShop docs ↗

Does your site have this issue?

Run a free SEOLZ audit to find missing schema howto — and every other issue — across your whole site in minutes.

Scan my site free

Frequently asked questions

What is Missing schema howto?

Structured data is hidden code — written in a format called JSON-LD — that you add to a web page to tell search engines exactly what the content means, not just what it says. HowTo schema marks up step-by-step instructional content (like "How to assemble your product" or "How to apply for a return") so Google can understand each step individually. BreadcrumbList schema tells Google the navigation path to the page (e.g. Home › Help › Returns), which shows up as a readable trail in search results. Neither type is visible to shoppers; it lives quietly in the page's code and speaks directly to search engines and AI answer tools.

Why does missing schema howto matter?

Pages with valid HowTo structured data are eligible for rich results — expanded, step-by-step listings in Google Search that take up significantly more screen space than a plain blue link, driving higher click-through rates. They are also prime candidates for Google's AI Overviews and other answer-engine features that pull structured steps directly into zero-click answers, putting your brand in front of shoppers before they even visit a competitor. BreadcrumbList markup improves how your URL path is displayed in search results, which has been shown to increase trust and clicks. Missing these schema types means leaving visible, high-intent real estate on the search results page empty — and handing it to competitors who have implemented them.

How do I fix missing schema howto?

Add HowTo and BreadcrumbList structured data (JSON-LD) to pages that contain step-by-step instructions so Google can display them as rich results and answer-engine snippets.

Authoritative references

Related Answer Engine Optimization issues