Skip to main content
Beta: Front-End Checklist is currently in beta. Some issues are still being fixed. Thanks for your patience.
SEOMedium

Implement valid BreadcrumbList schema

Adds structured data to breadcrumb navigation for better site hierarchy and search appearance.

Utilities
Quick take
Typical fix time 10 min
  • Add `BreadcrumbList` structured data to all pages except the homepage
  • Ensure the breadcrumb path matches the site's logical hierarchy
  • Use JSON-LD to mark up each item in the breadcrumb trail correctly
Why it matters: Breadcrumbs help search engines understand your site's structure and often appear in search results, improving navigation and click-through rates.

Rule Details

Breadcrumbs provide a secondary navigation path for users and a clear hierarchical map for search engines.

Code Example

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [{
    "@type": "ListItem",
    "position": 1,
    "name": "Blog",
    "item": "https://example.com/blog"
  },{
    "@type": "ListItem",
    "position": 2,
    "name": "SEO Tips",
    "item": "https://example.com/blog/seo-tips"
  }]
}
</script>

Why It Matters

  • Search Appearance: Replaces long, messy URLs in search snippets with a clean, clickable navigation path.
  • Crawlability: Helps search engines understand the relationship between different pages and categories.
  • User Experience: Allows users to quickly navigate back to higher-level categories or the homepage.
  • Internal Linking: Automatically creates a strong internal linking structure based on your site's hierarchy.

Exceptions

  • Only add or enforce schema types that the page can truthfully support; irrelevant structured data is worse than no structured data.
  • A technically valid schema block can still be misleading if the page content does not visibly back it up; audit rendered content and schema together.
  • If indexability, canonical-url, or main content quality is wrong, fix that foundation before optimizing schema details.

Standards

  • Use these references as the standard for the final search-facing HTML, metadata, and crawl behavior.
  • Check the implementation against Google Search Central: Search Essentials before treating the rule as satisfied.
  • Check the implementation against Google Search Central documentation before treating the rule as satisfied.

Verification

Automated Checks

  • Inspect rendered HTML and HTTP headers to confirm the expected metadata or crawlability signal is present.
  • Test the affected URL with Google Search Console or equivalent tooling where relevant.
  • Re-crawl a representative page set after deployment.

Manual Checks

  • Confirm the change does not create conflicting canonical-url, robots, or structured-data signals.

Use with AI

Copy these prompts to use with your AI assistant, or install the MCP server to use directly from Claude, Cursor, or Windsurf.

Check

Verify implementation

Verify that the page contains valid `BreadcrumbList` structured data matching the visible breadcrumbs.

Fix

Auto-fix issues

Implement a JSON-LD script that defines each level of the page's hierarchy using `ListItem` properties.

Explain

Learn more

Explain how breadcrumb schema replaces URLs in search results with a more readable navigation path.

Review

Code review

Review metadata generation, rendered HTML, structured data, and response headers related to Implement valid BreadcrumbList schema. Flag exact routes or templates where search-facing output violates the rule, and describe how to verify the final page output.

Sources

References used to support the guidance in this rule.

Further Reading

Tools and supplementary material for exploring the topic in more depth.

Google Search Console
search.google.comTool

Rules that often go hand-in-hand with this one.

Implement valid Article structured data

Validates that articles use the correct Schema.org properties for improved search visibility.

SEO
Add structured data markup

Schema.org structured data (JSON-LD) is implemented for rich search results.

SEO
Add VideoObject schema to video pages

Checks for VideoObject structured data on pages containing video content to enable video rich results in Google Search.

SEO
Implement comprehensive author markup

Uses structured data to provide machine-readable metadata about content authors.

SEO

Was this rule helpful?

Your feedback helps improve rule quality. This stays internal for now.

Loading feedback...
0 / 385