How to fix missing schema howto on Adobe Commerce (Magento)
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 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.
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 Adobe Commerce (Magento) 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