SEOLZ

Missing schema breadcrumblist

Moderate effort

Found on 42% of audited stores.

Add BreadcrumbList structured data (JSON-LD) to every page so Google can display your site's navigation path directly in search results.

What it is

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.

Why it matters

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.

How to fix it

  1. Identify every page type that needs breadcrumbs: homepage (optional), category pages, subcategory pages, product pages, and blog/article pages.
  2. For each page type, map the full breadcrumb path — every ancestor from Home down to the current page — and confirm each step has a stable, canonical URL.
  3. Create a JSON-LD script block using the BreadcrumbList schema: set @context to https://schema.org, @type to BreadcrumbList, and itemListElement to an array of ListItem objects each with a sequential position (1, 2, 3…), a name (the label shown), and an item (the full URL).
  4. Inject that <script type="application/ld+json"> block into the <head> or <body> of the rendered HTML for every applicable page — ideally dynamically/templated so it stays accurate as URLs or category names change.
  5. Ensure the breadcrumb names and URLs in the schema exactly match the visible breadcrumb links shown on the page; mismatches can cause Google to ignore or distrust the markup.
  6. Validate the implementation using Google's Rich Results Test and Google Search Console's Enhancements report to confirm the schema is parsed correctly and eligible for rich results.
{
  "@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/"
    }
  ]
}

Fix it on your platform

Pick your platform for the exact steps.

How to fix missing schema breadcrumblist on Shopify
  1. From your Shopify Admin, go to Online Store → Themes → click the three-dot menu on your live theme → Edit code.
  2. Open the template files where you want breadcrumbs: typically 'templates/product.liquid', 'templates/collection.liquid', and 'templates/page.liquid'.
  3. Paste a <script type="application/ld+json"> block containing the BreadcrumbList JSON-LD just before the closing </head> tag or at the top of the template body section. Use Liquid variables ({{ product.title }}, {{ collection.title }}, {{ shop.url }}) to populate name and item fields dynamically.
  4. Alternatively, install a structured data app such as 'Schema Plus for SEO' or 'JSON-LD for SEO' from the Shopify App Store — these auto-generate BreadcrumbList (and other schema types) across all page types without manual coding.
  5. Validate by visiting a product or collection page, viewing page source, and searching for 'BreadcrumbList', then test the URL in Google's Rich Results Test.
Full Shopify guide →Official Shopify docs ↗
How to fix missing schema breadcrumblist on WooCommerce
  1. Install the free Yoast SEO or Rank Math SEO plugin from Plugins → Add New in your WordPress admin if not already installed.
  2. For Yoast SEO: go to SEO → Search Appearance → Breadcrumbs tab, enable breadcrumbs, configure the separator and homepage label, then enable the Yoast structured data feature (it automatically outputs BreadcrumbList JSON-LD on shop, category, and product pages).
  3. For Rank Math: go to Rank Math → Titles & Meta → Products; structured data including BreadcrumbList is output automatically once Rank Math's Schema module is active.
  4. If you prefer manual control, add the JSON-LD block to your child theme's 'single-product.php' or 'archive.php' templates using wp_head() hooks and PHP to dynamically build the breadcrumb path from WooCommerce term data.
  5. Validate each page type (shop, category, product) with Google's Rich Results Test.
Full WooCommerce guide →Official WooCommerce docs ↗
How to fix missing schema breadcrumblist on BigCommerce
  1. Log in to your BigCommerce control panel and go to Storefront → My Themes → click Customize on your active theme → Advanced → Edit Theme Files (or use the Stencil CLI for local editing).
  2. Open the relevant Handlebars template files: 'templates/pages/product.html', 'templates/pages/category.html', and 'templates/pages/brand.html'.
  3. Add a <script type="application/ld+json"> block in each template, using Handlebars expressions ({{product.name}}, {{urls.home}}, {{category.url}}) to populate the BreadcrumbList items dynamically.
  4. Alternatively, use a BigCommerce app from the App Marketplace (search 'SEO' or 'structured data') such as 'SEO Manager' or 'Schema App Structured Data' which handle BreadcrumbList injection automatically.
  5. After saving, test a live product and category URL in Google's Rich Results Test to confirm the schema renders correctly.
Full BigCommerce guide →Official BigCommerce docs ↗
How to fix missing schema breadcrumblist on Wix
  1. In the Wix Editor, open the page where you want to add breadcrumb schema (e.g. a dynamic product or category page).
  2. Click the '+' (Add Elements) button → Embed & Social → Custom Embeds → Embed a Widget (or use 'HTML iframe' for a static page).
  3. Paste your complete <script type="application/ld+json"> BreadcrumbList block into the HTML/Embed code box. For dynamic pages (Wix Stores), you will need to hard-code per-page values or use Velo (Wix's dev platform) to write code in the page's 'Page Code' section that dynamically constructs and injects the JSON-LD based on dataset/collection values.
  4. In Wix Stores specifically, go to your Wix dashboard → SEO Tools → SEO Settings for your product or collection pages; Wix generates some structured data automatically but BreadcrumbList may need the Velo approach for full control.
  5. Publish the site, then validate a live page URL in Google's Rich Results Test.
Full Wix guide →Official Wix docs ↗
How to fix missing schema breadcrumblist on Squarespace
  1. In Squarespace, go to Website → Pages → click the Settings gear on a specific page → Advanced → Code Injection (this option is available on Business plan and above).
  2. Paste your <script type="application/ld+json"> BreadcrumbList block into the Header code injection field for that page.
  3. For site-wide injection across all pages (more efficient), go to Settings → Advanced → Code Injection → Header and add the script there — but note this requires you to hard-code or use Squarespace JSON template tags to dynamically generate the breadcrumb path per page type, which is limited.
  4. For a more automated solution, consider a third-party SEO integration or Squarespace Extension that handles structured data — search the Squarespace Extensions directory for 'SEO' or 'structured data'.
  5. After saving, test individual page URLs in Google's Rich Results Test to confirm the BreadcrumbList is detected.
Full Squarespace guide →Official Squarespace docs ↗
How to fix missing schema breadcrumblist on Webflow
  1. Open your Webflow project in the Designer. Select the page you want to edit from the Pages panel.
  2. Open Page Settings (click the gear icon next to the page name) → scroll down to the 'Custom Code' section → paste your <script type="application/ld+json"> BreadcrumbList block into the 'Before </body> tag' or 'Inside <head> tag' field.
  3. For Collection pages (CMS-driven product or category pages), use Webflow's CMS bindings: in the Custom Code field, reference CMS field slugs using Webflow embed code expressions so the breadcrumb name and item URL update automatically for each collection item.
  4. For a more scalable approach, add an 'HTML Embed' element inside your Collection page template and bind CMS fields to dynamically construct the JSON-LD.
  5. Publish the site, then validate a live Collection item URL in Google's Rich Results Test.
Full Webflow guide →Official Webflow docs ↗
How to fix missing schema breadcrumblist on 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.
Full Adobe Commerce (Magento) guide →Official Adobe Commerce (Magento) docs ↗

Does your site have this issue?

Run a free SEOLZ audit to find missing schema breadcrumblist — and every other issue — across your whole site in minutes.

Scan my site free

Frequently asked questions

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.

Why does missing schema breadcrumblist matter?

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.

How do I fix missing schema breadcrumblist?

Add BreadcrumbList structured data (JSON-LD) to every page so Google can display your site's navigation path directly in search results.

Authoritative references

Related Answer Engine Optimization issues