When the user wants to add, optimize, or audit breadcrumb navigation. Also use when the user mentions "breadcrumbs," "breadcrumb trail," "breadcrumb nav," "breadcrumb links," "path navigation," "site breadcrumb," "BreadcrumbList schema," "location-based breadcrumb," "attribute-based breadcrumb," "site hierarchy display," "add breadcrumbs," or "breadcrumb SEO." For BreadcrumbList JSON-LD, use schema-markup. For main nav, use navigation-menu-generator.
Guides breadcrumb implementation for SEO, UX, and GEO. Breadcrumbs show users their location in the site hierarchy and help search engines understand content taxonomy. Well-implemented breadcrumbs can increase CTR by 20–30%, reduce bounce rates by up to 30%, and strengthen internal linking.
When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.
BreadcrumbList schema: JSON-LD structured data for rich results
Placement: Typically below header, above main content
Breadcrumb Types
Type
Use case
Recommendation
Location-based
Reflects site hierarchy (Home > Blog > SEO > Page)
Recommended — most SEO-friendly; clear structure
Attribute-based
Shows product attributes (Home > Electronics > Phone > iPhone 15) | E-commerce; product classification |
| Path-based | Shows user's browsing path | Avoid — different users, different paths; can cause confusion |
Default: Use location-based for most sites. Use attribute-based for e-commerce product pages.
Initial Assessment
Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for site structure and key pages.
Identify:
1. Site structure: Hierarchy depth (e.g., Home > Category > Subcategory > Product)
Page types: Blog, e-commerce, docs, etc.
Multi-category: Products in multiple categories—need canonical path
Best Practices
Structure & Hierarchy
Practice
Guideline
Depth
3–5 levels optimal; avoid very long trails
Anchor text
Keyword-rich, human-readable; descriptive |
| Consistency | Same pattern across all pages (blog, category, product) |
| Canonical path | For items in multiple categories, define one canonical breadcrumb to avoid diluted link equity |
Schema (BreadcrumbList)
See schema-markup for BreadcrumbList requirements, JSON-LD example, and multiple paths. Schema must match visible breadcrumbs exactly.
Placement & Design
Practice
Guideline
Position
Below nav bar or above page title; top of content area
Visual
Smaller font, lighter color; avoid competing with main content |
| Separator | Clear separator (>, /, ›); consistent across site |
| Naming | Match page title or nav menu; concise, descriptive |
UX & Accessibility
Practice
Guideline
Mobile
Tappable; short, readable text; high contrast
Long trails
Horizontal scroll container rather than truncating |
| Current page | Last item non-linked; use aria-current="page" |
| Screen readers | nav with aria-label="Breadcrumb"; proper landmark |
SEO Impact
- Internal linking: Breadcrumbs distribute link equity
Crawlability: Helps crawlers understand taxonomy
GEO: BreadcrumbList appears frequently on pages cited by Google AI Mode
Note: Google removed visual breadcrumbs from mobile SERPs (Jan 2025) to save space, but schema and algorithmic value remain important for crawlers and AI. See serp-features for breadcrumb SERP display.
Implementation
Semantic HTML
CODEBLOCK0
Implementation: Generate BreadcrumbList from route segments or page metadata. Ensure item URLs are absolute. Use next-seo BreadcrumbJsonLd or custom component. See schema-markup for JSON-LD structure.
When to Use Breadcrumbs
Site type
Use case
E-commerce
Category > Subcategory > Product
Blog
Home > Blog > Category > Post (see article-page-generator for article page structure) |
| Docs | Home > Docs > Section > Page |
| Large sites | Any site with 3+ level hierarchy |
Skip on flat sites (e.g., single-page, 1–2 level depth).
Deep pages: For 6+ levels, consider omitting middle levels; show only the most important categories to avoid clutter.
Platform Notes
Platform
Options
WordPress
Yoast SEO, Rank Math, Breadcrumb NavXT
Next.js
next-seo BreadcrumbJsonLd, custom from route segments |
| Shopify, Drupal, Joomla | Built-in or plugin support |
Common Errors
Error
Fix
Relative URLs in schema
Use absolute URLs (https://)
Schema doesn't match visible trail
Keep schema and UI in sync |
| Missing position | Include sequential position (1, 2, 3…) |
| Last item linked | Current page typically not a link |
| Too many levels | Limit to 5–7; omit middle levels for deep paths |
| Inaccurate path | Breadcrumb must reflect actual site structure |
| No schema | Add BreadcrumbList per schema-markup; otherwise no SERP breadcrumbs; see serp-features |
Output Format
- Structure recommendation (levels, labels)
BreadcrumbList JSON-LD — see schema-markup for structure; with absolute URLs
