How to fix missing schema breadcrumblist on Adobe Commerce (Magento)
Add BreadcrumbList structured data (JSON-LD) to every page so Google can display your site's navigation path directly in search results.
Steps for Adobe Commerce (Magento)
- In your Magento admin, go to Content › Configuration › HTML Head or use a custom layout XML file in your theme: app/design/frontend/<Vendor>/<Theme>/Magento_Theme/layout/default_head_blocks.xml.
- Create or edit a custom PHP template block (e.g. app/design/frontend/<Vendor>/<Theme>/Magento_Theme/templates/breadcrumb_jsonld.phtml) that outputs the JSON-LD using Magento's breadcrumb data model ($block->getCrumbs()).
- Register the block in a layout XML file (e.g. default.xml) with reference name='head.additional' so it outputs on every page.
- Alternatively, install a structured data extension from the Magento Marketplace (e.g. 'Rich Snippets' extensions) that handles BreadcrumbList automatically.
- Clear the Magento cache (System › Cache Management › Flush Cache Storage) and validate with Google's Rich Results Test.
What is missing schema breadcrumblist?
Breadcrumb structured data is a small block of code — written in a format called JSON-LD — that you add to your page's HTML to tell Google exactly how that page fits into your site's hierarchy (e.g. Home → Women's Clothing → Dresses → Blue Wrap Dress). Google reads this code, not just your visible breadcrumb links, to understand and display your site structure. Without it, Google has to guess your site's structure, and you miss out on the enhanced appearance it enables in search results. The BreadcrumbList schema type is the recognised, standardised way to communicate this information.
Pages with BreadcrumbList markup are eligible for breadcrumb trails in Google's search result snippets — the "Home › Category › Product" line shown below the page title. This richer appearance improves click-through rates, which directly drives more organic traffic and revenue. It also helps Google crawl and categorise your site more accurately, which can improve rankings for category and product pages. For Answer Engine Optimisation (AEO), structured data is one of the clearest signals you can send to help AI-powered search experiences surface your pages with confidence. Omitting it leaves a straightforward, high-value SEO win completely unclaimed.
See the complete Missing schema breadcrumblist 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 breadcrumblist and every other issue across your whole site.
Scan my site free