How to fix missing schema breadcrumblist on Adobe Commerce (Magento)

Steps for Adobe Commerce (Magento)

1. SSH into your server or open your IDE and navigate to your active theme directory: app/design/frontend/<Vendor>/<theme>/.
2. Create or edit the layout XML file for product pages (Magento_Catalog/layout/catalog_product_view.xml) and category pages (catalog_category_view.xml) to add a new block that renders your JSON-LD.
3. Create a corresponding PHTML template (e.g. Magento_Catalog/templates/structured_data/breadcrumb.phtml) that uses Magento's breadcrumb data model ($block->getCrumbs()) to loop over the breadcrumb items and output a valid BreadcrumbList JSON-LD <script> block dynamically.
4. Alternatively, install a structured data extension from the Adobe Commerce Marketplace (e.g. 'Structured Data' by Mageworx or similar) which auto-generates BreadcrumbList schema across all page types without custom development.
5. Run bin/magento setup:upgrade && bin/magento cache:flush, then validate a product and category page in Google's Rich Results Test.

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://example.com/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Women's Clothing",
      "item": "https://example.com/womens-clothing/"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Dresses",
      "item": "https://example.com/womens-clothing/dresses/"
    }
  ]
}

What is missing schema breadcrumblist?

Breadcrumb structured data is a small snippet of code — written in a format called JSON-LD — that you embed in your page's HTML to tell Google exactly how that page fits into your site's hierarchy (e.g. Home → Women's Clothing → Dresses). Without it, Google has to guess your site structure on its own, which is less reliable. The BreadcrumbList schema uses a standardized vocabulary from Schema.org so search engines can read it unambiguously. It is separate from the visible breadcrumb links you may already show on the page, though ideally both exist and match each other.

Adding BreadcrumbList schema can trigger a "breadcrumb" rich result in Google Search — instead of showing a raw URL under your page title, Google shows a clean, human-readable path like "example.com › Women's Clothing › Dresses." This improves click-through rates because shoppers immediately understand where the page sits and trust the result more. It also helps Google understand your site's category structure, which can strengthen topical relevance signals and internal-linking value across your catalog. For larger stores with hundreds of category and product pages, the cumulative traffic and conversion impact of improved CTR is significant.

See the complete Missing schema breadcrumblist guide for every platform and the full background.