Breadcrumb Structured Data: Complete Implementation Guide

Why Use BreadcrumbList Schema?

• Replaces raw URLs in search results with a readable breadcrumb trail, improving user understanding of page context
• Helps search engines understand your site hierarchy and the relationships between pages
• Increases click-through rates by giving users confidence about where they will land on your site
• Easy to implement at scale using templates, making it one of the best effort-to-reward structured data types
• Supports multiple breadcrumb trails for pages accessible through different navigation paths

Required Properties

These properties are required by Google for BreadcrumbList structured data to be eligible for rich results.

Recommended Properties

Adding these properties improves your chances of appearing in rich results and provides more context to search engines.

JSON-LD Example

Here is a complete BreadcrumbList structured data example you can use as a starting point. Or use our BreadcrumbList generator to create one automatically.

<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": "Running Shoes",
      "item": "https://example.com/shoes/running"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Trail Running Shoes",
      "item": "https://example.com/shoes/running/trail"
    },
    {
      "@type": "ListItem",
      "position": 4,
      "name": "Salomon Speedcross 6 Review"
    }
  ]
}
</script>

How to Implement BreadcrumbList Schema

1. 1Map out your site hierarchy and identify the breadcrumb trail for each page template. Most sites follow a pattern like Home > Category > Subcategory > Page.
2. 2Create a JSON-LD script block containing a BreadcrumbList with an itemListElement array ordered from the top-level page to the current page.
3. 3For each breadcrumb step, add a ListItem with position (starting at 1), name, and item (the URL). Omit the item property on the final breadcrumb representing the current page.
4. 4Implement the markup dynamically in your page template so it automatically generates the correct breadcrumb trail based on the page's position in your site structure.
5. 5Validate the markup using Google's Rich Results Test on several pages at different depths to ensure the trails are correct throughout your site.

Common Mistakes to Avoid

• Including the item URL on the last breadcrumb in the trail. The final item should only have a position and name, as it represents the current page.
• Using position values that do not start at 1 or that skip numbers. Positions must be sequential integers beginning with 1.
• Mismatching the breadcrumb trail in structured data with the visible breadcrumbs displayed on the page. Google expects consistency between markup and on-page content.
• Hardcoding breadcrumb markup rather than generating it dynamically from the site structure, leading to stale or incorrect trails when pages are reorganised.
• Omitting the homepage as the first breadcrumb. Always start the trail with your root page to give search engines a complete path.

Testing & Validation

Before deploying your BreadcrumbList structured data, validate it using these tools:

1. 1Google Rich Results Test — Paste your page URL or code snippet to check if your structured data is eligible for rich results.
2. 2Schema Markup Validator — Validates your JSON-LD syntax against the schema.org specification.
3. 3Google Search Console — After deployment, monitor the Enhancements report for any errors or warnings.

Frequently Asked Questions