How to fix missing schema howto on Adobe Commerce (Magento)
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.
Steps for Adobe Commerce (Magento)
- For CMS pages: go to Content › Pages › select the instructional page › Edit › Content tab.
- In the page content (HTML editor / Page Builder), add an HTML element and paste the <script type='application/ld+json'>…</script> block.
- 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.
- 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.
- BreadcrumbList can be added the same way or generated dynamically by a schema extension that reads Magento's built-in breadcrumb trail.
- Validate with Google's Rich Results Test.
{
"@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/"
}
]
}
]
}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.
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.
See the complete Missing schema howto guide for every platform and the full background.
Not sure if your Adobe Commerce (Magento) store has this?
Run a free SEOLZ audit — we’ll find missing schema howto and every other issue across your whole site.
Scan my site free