How to Fix Missing Breadcrumbs and BreadcrumbList Schema

This check flags pages that sit two or more levels below your homepage but have no BreadcrumbList structured data. By the end of this guide you will have a visible breadcrumb trail on those pages, matching BreadcrumbList JSON-LD in the page source, and a way to confirm that Google reads it.

By Updated ⏱ 30-90 minutes (template-level change)🎯 Intermediate● Medium impactOn-Page
Illustration: Breadcrumb navigation fix guide
ON-PAGE · FIX GUIDE Breadcrumb navigation IMPACTEFFORT TIME30-90 minutes (template-level change) LEVELIntermediate

Why it matters

Breadcrumb schema tells search engines exactly where a page sits in your hierarchy, such as Home > Shoes > Running Shoes. Google uses it to understand site structure and to show a breadcrumb path instead of a raw URL in desktop results. AI answer engines use it to understand how products and articles relate to each other.

Visible breadcrumbs also add internal links to parent categories, which pass link equity upward. They also give visitors who land deep from search a one-click way back to broader pages, which reduces pogo-sticking.

✕Beforehttps://example.com/shop/shoes/trail-runner-xhas no breadcrumb trail and no✓AfterThe page shows Home > Shoes > TrailRunner X and includes a BreadcrumbListJSON-LD block with three ListItem

What you need

Access to your theme/templates or a CMS SEO plugin
A clear map of your category or folder hierarchy
Google's Rich Results Test (search.google.com/test/rich-results)
Access to Google Search Console for the property (optional, used for monitoring)

Step-by-step fix

1

List the deep pages and their parent paths

Export the flagged URLs from your audit. For each page type, write the trail a user should see. Template types include product, blog post, subcategory and doc page.

Base the trail on your real hierarchy rather than just the URL folders:

  • Product: Home > Category > Product
  • Blog post: Home > Blog > Category > Post
  • Docs: Home > Docs > Section > Article

You fix templates, not individual pages, so usually only 3-5 trail patterns are needed.

Pro tip: If a product lives in several categories, choose one primary category for the breadcrumb and stick with it. It should normally match the canonical URL path.
2

Add a visible, accessible breadcrumb trail

Place the breadcrumb above the H1 in your page template. Use a nav element with aria-label="Breadcrumb" and an ordered list. Mark the current page with aria-current="page", and don't link it.

Every ancestor should be a real link to an indexable page.

html
<nav aria-label="Breadcrumb" class="breadcrumb">
  <ol>
    <li><a href="https://example.com/">Home</a></li>
    <li><a href="https://example.com/shop/shoes/">Shoes</a></li>
    <li><span aria-current="page">Trail Runner X</span></li>
  </ol>
</nav>
Pro tip: Use CSS such as `.breadcrumb li + li::before { content: "/"; }` for separators. That way screen readers don't announce stray characters.
3

Add matching BreadcrumbList JSON-LD

Output a JSON-LD block in the same template, in the head or the body. Each step is a ListItem with position (starting at 1), name and item (an absolute URL). The item on the last element is optional, but including it is harmless.

The names and order must match the visible trail.

html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {"@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com/"},
    {"@type": "ListItem", "position": 2, "name": "Shoes", "item": "https://example.com/shop/shoes/"},
    {"@type": "ListItem", "position": 3, "name": "Trail Runner X", "item": "https://example.com/shop/shoes/trail-runner-x"}
  ]
}
</script>
Pro tip: Prefer JSON-LD over microdata or RDFa. It is Google's recommended format and the one audit tools parse most reliably.
4

Generate both outputs from one data source

Build the trail once as an array of name/URL pairs in your template. Render it twice: as the HTML nav and as the JSON-LD. This keeps the visible breadcrumb and the schema from drifting apart when someone renames a category.

javascript
// Next.js App Router example (app/shop/[cat]/[slug]/page.tsx)
const crumbs = [
  { name: 'Home', url: 'https://example.com/' },
  { name: category.title, url: `https://example.com/shop/${category.slug}/` },
  { name: product.title, url: `https://example.com/shop/${category.slug}/${product.slug}` }
];
const jsonLd = {
  '@context': 'https://schema.org',
  '@type': 'BreadcrumbList',
  itemListElement: crumbs.map((c, i) => ({ '@type': 'ListItem', position: i + 1, name: c.name, item: c.url }))
};
// In JSX:
// <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }} />
Pro tip: Render the JSON-LD on the server. Schema injected only after client-side JavaScript runs can be missed by crawlers and AI bots that don't execute JS.
5

Deploy and spot-check rendered source

Publish the template change. Open three or four previously flagged URLs and use View Source (Ctrl+U / Cmd+Option+U). Search for BreadcrumbList and confirm that it appears once per page, with correct, absolute URLs.

text
curl -s https://example.com/shop/shoes/trail-runner-x | grep -o '"@type": *"BreadcrumbList"'
Pro tip: Two BreadcrumbList blocks on one page usually means a plugin and your theme are both outputting it. Disable one of them.
6

Validate and re-run the audit

Paste a flagged URL into the Rich Results Test. Confirm that "Breadcrumbs" is detected with no errors. Then re-run the site audit and check that the count of deep pages without BreadcrumbList has dropped to zero.

Over the next few weeks, watch Search Console > Enhancements > Breadcrumbs for valid item counts rising.

Pro tip: The Schema Markup Validator (validator.schema.org) catches syntax problems the Rich Results Test ignores. Run both if you hand-write the JSON.

Platform-specific notes

WordPress (Yoast / Rank Math)

Yoast SEO includes a BreadcrumbList in its schema graph by default. To show it visibly, enable Yoast SEO > Settings > Advanced > Breadcrumbs, then add the yoast_breadcrumb() function or the Yoast Breadcrumbs block to your theme. In Rank Math, turn on Rank Math SEO > General Settings > Breadcrumbs. This enables the BreadcrumbList schema, and the [rank_math_breadcrumb] shortcode or block displays the trail. Many block themes also ship their own breadcrumb block without schema, so keep only one source.

Shopify

Most themes have no BreadcrumbList by default. Create snippets/breadcrumbs.liquid that builds the trail from `collection` and `product` objects and outputs both the nav and the JSON-LD. Render it in sections/main-product.liquid and main-collection.liquid with {% render 'breadcrumbs' %}. Products reached without a collection in the URL need a fallback, such as product.collections.first.

Wix

Add the Breadcrumbs element from Add Elements > Menu & Anchor. Wix generates breadcrumb structured data for some page types, such as store products and blog posts. For other pages, add custom markup under Page Settings > SEO > Advanced SEO > Structured Data Markup.

Webflow

There is no native breadcrumb schema. On CMS Template pages, add an Embed element holding the BreadcrumbList JSON-LD and insert CMS fields (Name, Slug, referenced Category) into the JSON. Build the visible trail with a link block bound to the same reference field.

Next.js / headless

Render the JSON-LD in a server component, as in step 4, so it is in the initial HTML. Derive the trail from your CMS taxonomy, not by splitting the URL path, because folder names are often not human-readable labels.

Check that it worked

✅ How to verify

  • Rich Results Test shows a valid "Breadcrumbs" item for a sample of previously flagged URLs
  • View Source on deep pages contains exactly one "@type": "BreadcrumbList" block, with absolute URLs
  • The re-run audit reports 0 deep pages without BreadcrumbList markup
  • Search Console > Enhancements > Breadcrumbs shows valid items increasing and no errors after recrawl

⚠️ Common mistakes

  • Adding only the visible trail (or a theme breadcrumb block) without BreadcrumbList schema, which still fails the check
  • Using relative URLs or homepage-only trails in the `item` property instead of absolute URLs that reflect the real hierarchy
  • Letting schema and the visible breadcrumb disagree, for example a different category name or order, which Google treats as misleading markup
  • Linking breadcrumb steps to category URLs that are noindexed, redirected or 404, which wastes crawl paths

Is this still an issue on your site? Run a free audit — ZORO checks this and 294 other SEO, AI-visibility, accessibility and security signals, with fixes for your platform.

Check my site free

FAQ

Does Google still show breadcrumbs in search results?

Since early 2025, Google no longer shows breadcrumb paths in mobile results; it shows just the domain. Desktop results still use breadcrumb markup. Google also continues to read BreadcrumbList to understand site structure, so it is still worth adding.

Do I need breadcrumbs on the homepage or top-level pages?

No. The homepage has no parent, and a page one level down would only show Home > Page. Focus on pages two or more levels deep, such as products, posts in categories and documentation articles.

Should the breadcrumb follow the URL structure or the navigation?

Follow the logical hierarchy a user would navigate. That is usually the same as your URL folders, but not always. When the two differ, the breadcrumb should point to real, indexable parent pages with readable names.

Can a page have more than one breadcrumb trail?

Google allows multiple BreadcrumbList blocks if a page genuinely sits in several paths. A single primary trail is clearer for users and avoids mixed signals, so use multiple only when needed.