BreadcrumbList Schema
Learn about BreadcrumbList schema markup for navigation breadcrumbs.
What is BreadcrumbList Schema?
BreadcrumbList schema markup helps search engines understand your site's navigation structure by defining the breadcrumb trail for each page. It creates a hierarchical path that shows users and search engines how to navigate from the homepage to the current page.
Why BreadcrumbList Matters
Most websites have some form of breadcrumb navigation, but without schema markup, search engines only see "some text links." BreadcrumbList schema tells search engines that these are structured navigation elements with specific hierarchical relationships.
The key insight: BreadcrumbList transforms your navigation from "pretty links" into "structured site hierarchy" that search engines can understand and potentially display in search results.
What BreadcrumbList Includes
SEO Benefits You Get
<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": "Products",
"item": "https://example.com/products"
},
{
"@type": "ListItem",
"position": 3,
"name": "Wireless Headphones",
"item": "https://example.com/products/wireless-headphones"
}
]
}
</script>Breaking Down the Structure
@type: Must be "BreadcrumbList"itemListElement: Array of ListItem objects
@type: Must be "ListItem"position: Number (1, 2, 3...)name: Display textitem: Full URL
Implementation Examples
E-commerce Product Page
For a product page like "Home > Electronics > Headphones > Wireless > Bose QC35"
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{"@type": "ListItem", "position": 1, "name": "Home", "item": "https://store.com"},
{"@type": "ListItem", "position": 2, "name": "Electronics", "item": "https://store.com/electronics"},
{"@type": "ListItem", "position": 3, "name": "Headphones", "item": "https://store.com/electronics/headphones"},
{"@type": "ListItem", "position": 4, "name": "Wireless", "item": "https://store.com/electronics/headphones/wireless"},
{"@type": "ListItem", "position": 5, "name": "Bose QC35", "item": "https://store.com/electronics/headphones/wireless/bose-qc35"}
]
}Blog Article Page
For a blog post like "Home > Blog > SEO > Schema Markup Guide"
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{"@type": "ListItem", "position": 1, "name": "Home", "item": "https://blog.com"},
{"@type": "ListItem", "position": 2, "name": "Blog", "item": "https://blog.com/blog"},
{"@type": "ListItem", "position": 3, "name": "SEO", "item": "https://blog.com/blog/seo"},
{"@type": "ListItem", "position": 4, "name": "Schema Markup Guide", "item": "https://blog.com/blog/seo/schema-markup-guide"}
]
}Important Implementation Notes
- ⚠️Match visible breadcrumbs: Schema should exactly match the breadcrumb navigation users see on your page
- ⚠️Use absolute URLs: Always include full URLs with https:// in the "item" property
- ⚠️Sequential positions: Position numbers must be sequential starting from 1
- ⚠️Logical hierarchy: Each level should be a logical parent of the next level
Common Mistakes & Best Practices
❌ Wrong: Inconsistent with Visible Navigation
Mistake: Schema breadcrumbs don't match what users see on the page.
Fix: Ensure your schema exactly matches your visible breadcrumb navigation. If users see "Home > Shop > Electronics," your schema should reflect the same structure.
❌ Wrong: Missing or Broken URLs
Mistake: Using relative URLs or broken links in the "item" property.
Fix: Always use absolute URLs (starting with https://) and ensure all URLs are working and accessible.
✅ Best Practice: Keep it Simple
Tip: Don't include too many breadcrumb levels. 3-5 levels is usually optimal.
Why: Overly complex breadcrumbs can confuse both users and search engines. Focus on the most important navigation hierarchy.
✅ Best Practice: Use Clear Names
Tip: Use descriptive, user-friendly names for each breadcrumb level.
Why: Clear names help search engines better understand your site structure and improve the user experience if breadcrumbs appear in search results.
Validate Your Breadcrumb Schema
Test your BreadcrumbList implementation to ensure proper navigation structure and hierarchy definition.
Our comprehensive validation tool
Official Google testing tool
Related Schema Types
BreadcrumbList schema works alongside these navigation and structure schemas.