Missing schema howto
Moderate effortFound on 62% of audited stores.
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.
What it is
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.
Why it matters
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.
How to fix it
- Identify every page on your site that describes a multi-step task — product usage guides, assembly instructions, care guides, tutorials, recipe-style content, or any 'how to' article.
- For each qualifying page, draft the HowTo JSON-LD block: give it a descriptive 'name', list each step as a separate HowToStep object with a 'text' property (and optionally a 'name' headline and 'image'), and include optional fields like 'totalTime' (ISO 8601, e.g. PT30M), 'estimatedCost', 'supply', and 'tool' to enrich the result.
- Paste the completed JSON-LD inside a <script type='application/ld+json'> tag and inject it into the <head> (or just before </body>) of the specific page — do NOT add it site-wide unless every page is a how-to.
- Validate the markup with Google's Rich Results Test (search 'Rich Results Test') by pasting either the live URL or the raw code snippet, and confirm zero errors before publishing.
- Publish the page and monitor Google Search Console > Enhancements > HowTo over the following weeks to track impressions, clicks, and any validation warnings that appear after Google crawls the updated page.
Fix it on your platform
Pick your platform for the exact steps.
How to fix missing schema howto on Shopify
- In your Shopify admin, go to Online Store > Themes > (your active theme) > Edit code.
- For a blog post or page: open the template file that renders that content type — typically 'templates/article.liquid' or 'templates/page.liquid'.
- Scroll to the bottom of the file (or find the closing </article> tag) and paste your complete <script type='application/ld+json'> HowTo block there. Use Liquid variables like {{ article.title | json }} to pull dynamic values if desired.
- Alternatively, for a specific page only, go to Online Store > Pages, open the page, switch the content editor to HTML mode, and paste the JSON-LD script block at the very bottom of the HTML content.
- Save the file, then validate the live URL with Google's Rich Results Test.
How to fix missing schema howto on WooCommerce
- Install a structured data plugin such as 'Rank Math SEO' or 'Schema Pro' from the WordPress plugin directory (Plugins > Add New).
- In Rank Math: edit the specific post or page, open the Rank Math sidebar panel > Schema tab, click 'Add New Schema', choose 'HowTo', and fill in the step-by-step form fields — no code required.
- In Schema Pro (Settings > Schema Pro > Add New): assign the HowTo schema type to the specific page or post type, then map fields to your content.
- If you prefer manual code: open your child theme's functions.php and use wp_head action to inject the JSON-LD only on the relevant page (use is_page() or is_single() conditional checks).
- Validate with Google's Rich Results Test after saving.
How to fix missing schema howto on BigCommerce
- Go to Storefront > Script Manager in your BigCommerce admin.
- Click 'Create a Script', set Location to 'Footer', select the specific Page type ('Web Pages' for static pages or 'All Pages' with a conditional), and paste your complete JSON-LD HowTo script block into the script body.
- For blog posts, edit the specific blog post (Content > Blog), switch to HTML source view, and paste the <script type='application/ld+json'> block at the end of the post HTML.
- Alternatively, edit the relevant Stencil template file (e.g. templates/pages/blog-post.html) via Stencil CLI and inject the JSON-LD block inside the <head> partial.
- Validate the live URL with Google's Rich Results Test.
How to fix missing schema howto on Wix
- Open the Wix Editor and navigate to the specific page that contains how-to content.
- Click the page Settings (gear icon next to the page name in the Pages panel) > Advanced > Custom Code (or go to Settings > Custom Code in the main dashboard).
- Click '+ Add Custom Code', paste your complete JSON-LD HowTo block, set it to load in the <head>, choose 'Load code once' or 'Load code on each new page', scope it to 'Specific pages' and select only this page.
- Publish the site and validate with Google's Rich Results Test.
How to fix missing schema howto on Squarespace
- In your Squarespace admin, go to Settings > Advanced > Code Injection for site-wide injection, OR open the specific page > Page Settings > Advanced > Page Header Code Injection for page-level injection (preferred).
- Paste your complete <script type='application/ld+json'> HowTo block into the Header Code Injection box for that page.
- Save and publish, then validate the live URL with Google's Rich Results Test.
- Note: Code Injection is available on Business plan and above.
How to fix missing schema howto on Webflow
- In the Webflow Designer, select the specific page in the Pages panel and click the gear icon to open Page Settings.
- Scroll to 'Custom Code' > 'Inside <head> tag' section and paste your complete JSON-LD HowTo block there.
- Alternatively, for a CMS Collection page (e.g. a blog post template), open the Collection template page settings the same way and use Webflow's dynamic data bindings to pull step content from CMS fields.
- Publish the site and validate with Google's Rich Results Test.
How to fix missing schema howto on Adobe Commerce (Magento)
- Identify the CMS Page or CMS Block that contains the how-to content (Content > Pages or Content > Blocks in the admin).
- Edit the page, switch the content editor to HTML mode, and paste your <script type='application/ld+json'> HowTo block at the bottom of the HTML.
- For a more scalable solution, create a custom layout XML file (e.g. cms_page_view_id_your-page-identifier.xml) inside your theme at app/design/frontend/<Vendor>/<theme>/Magento_Cms/layout/ and add a block of type Magento\Framework\View\Element\Template that renders a .phtml file containing the JSON-LD.
- Flush the Magento cache (System > Cache Management > Flush Magento Cache) and validate the live URL with Google's Rich Results Test.
How to fix missing schema howto on WordPress.org
- Install 'Rank Math SEO' (free) or 'Yoast SEO' (with Schema add-on) from Plugins > Add New.
- In Rank Math: edit the target post/page, click the Rank Math icon in the editor toolbar, go to the Schema tab, click 'Add New Schema', select 'HowTo', and complete the step form fields interactively.
- For manual implementation: in your child theme's functions.php, add a function hooked to wp_head that outputs the JSON-LD block inside an is_page('your-slug') conditional, then call wp_enqueue_scripts or add_action('wp_head', 'your_function_name').
- Validate with Google's Rich Results Test after updating.
How to fix missing schema howto on Wix Studio
- Open Wix Studio and navigate to the target page.
- Click the page name in the layers/pages panel > Page SEO Settings > Advanced SEO tab.
- Paste your complete JSON-LD HowTo block into the 'Structured Data Markup' or custom head code area.
- Publish and validate with Google's Rich Results Test.
How to fix missing schema howto on Webflow Commerce
- In the Webflow Designer, open the specific Product or CMS page that contains how-to content via the Pages panel.
- Click the gear icon for Page Settings > Custom Code > 'Inside <head> tag'.
- Paste your complete JSON-LD HowTo block. For product how-to guides in CMS, bind step text to CMS fields using Webflow's embed component with dynamic content.
- Publish and validate with Google's Rich Results Test.
How to fix missing schema howto on Shopify Plus
- 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.
- 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' %}).
- Use a structured data management app from the Shopify App Store for a no-code approach.
- Validate with Google's Rich Results Test.
How to fix missing schema howto on Drupal
- Install the 'Schema.org Metatag' module or 'Metatag' module with the JSON-LD submodule from drupal.org.
- Configure schema mappings for the relevant content type (e.g. 'How-to Guide') under Configuration › Search and Metadata › Metatag.
- 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.
- BreadcrumbList is handled by the 'Simple XML Sitemap' or Metatag modules, or via a custom hook_preprocess_page().
- Validate with Google's Rich Results Test.
How to fix missing schema howto on PrestaShop
- Use a structured data module from the PrestaShop Marketplace (search 'JSON-LD schema') or add custom code.
- 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>.
- 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'.
- Validate with Google's Rich Results Test.
How to fix missing schema howto on Next.js (Headless)
- Identify every page that contains a multi-step process (assembly guides, tutorials, recipe pages, setup flows, etc.) — these are the target routes in your `app/` or `pages/` directory.
- Create a reusable `HowToJsonLd` component (e.g. `components/seo/HowToJsonLd.tsx`) that accepts the schema props and renders a `<script type='application/ld+json'>` tag via Next.js's `<Script>` or a plain `<script>` inside a Server Component.
- In each target page file (e.g. `app/guides/[slug]/page.tsx`), fetch or import your step data, build the HowTo schema object, and render `<HowToJsonLd>` in the JSX return — no `<head>` manipulation needed in the App Router because Next.js hoists inline scripts correctly.
- If you are on the *Pages Router* (`pages/guides/[slug].tsx`), import `Head` from `next/head` and place the `<script type='application/ld+json'>` tag inside `<Head>` instead.
- Validate the output with Google's Rich Results Test (https://search.google.com/test/rich-results) and the Schema Markup Validator (https://validator.schema.org/) before deploying.
- Optionally extend `generateMetadata` (App Router) or the `<Head>` block with a descriptive `title` and `description` that matches the HowTo topic, reinforcing the AEO signal.
How to fix missing schema howto on Elementor
- In the WordPress dashboard, navigate to Elementor → Custom Code (requires Elementor Pro). Click '+ Add New' to create a new custom code snippet.
- Name the snippet (e.g. 'HowTo Schema – [Page Name]'), set the Location to 'Head', and set the Page Condition to target only the specific page(s) that contain the multi-step process (e.g. a tutorial, assembly guide, or how-to article page).
- In the code editor, paste a valid JSON-LD HowTo block, for example: <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "HowTo", "name": "How To [Task Name]", "description": "A brief description of what this guide accomplishes.", "step": [ {"@type": "HowToStep", "name": "Step 1 Title", "text": "Detailed instructions for step 1."}, {"@type": "HowToStep", "name": "Step 2 Title", "text": "Detailed instructions for step 2."}, {"@type": "HowToStep", "name": "Step 3 Title", "text": "Detailed instructions for step 3."} ] } </script> Replace all placeholder values with the real step names and descriptions that match the page content exactly.
- Click 'Publish' to activate the snippet. Then open the target page in Elementor's editor, confirm the visible on-page step content matches the schema data, and save/update the page.
- Validate the markup by visiting Google's Rich Results Test (https://search.google.com/test/rich-results), entering the page URL, and confirming it detects a valid HowTo result with no errors or warnings.
- If the page is new or recently updated, submit its URL in Google Search Console under URL Inspection → Request Indexing so Google can crawl and index the HowTo schema promptly.
Does your site have this issue?
Run a free SEOLZ scan to find missing schema howto — and every other issue — across your whole site in minutes.
Scan my site freeFrequently asked questions
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.
Why does missing schema howto matter?
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.
How do I fix missing schema howto?
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.
Authoritative references
- Intro to structured data — Google Search Central
- Getting started with schema.org — Schema.org
- Rich Results Test — Google Search Central