BreadcrumbList schema present on hierarchical pages
Why it matters
BreadcrumbList schema enables breadcrumb display in Google SERPs — the Home > Category > Item trail that appears below the page title. Without it, hierarchical pages miss a proven CTR signal: breadcrumbs communicate site structure at a glance and give users context before they click. schema-org BreadcrumbList and ListItem are among the most widely supported Rich Result types across Google, Bing, and AI-driven answer engines. Sites with three-level hierarchies that omit this schema systematically underperform peers who implement it.
Severity rationale
High because breadcrumb Rich Results are a direct CTR factor in SERPs, and their absence on hierarchical pages is a measurable, recoverable ranking-signal loss.
Remediation
Add BreadcrumbList schema to every hierarchical page component. For Next.js, generate it dynamically from the URL path in app/[category]/[slug]/page.tsx:
const breadcrumb = {
'@context': 'https://schema.org',
'@type': 'BreadcrumbList',
itemListElement: [
{ '@type': 'ListItem', position: 1, name: 'Home', item: 'https://yoursite.com' },
{ '@type': 'ListItem', position: 2, name: category.label, item: `https://yoursite.com/${category.slug}` },
{ '@type': 'ListItem', position: 3, name: item.title, item: `https://yoursite.com/${category.slug}/${item.slug}` },
],
}
Every ListItem requires position, name, and item (the full URL). Missing any one property invalidates the breadcrumb for Rich Results. Confirm with the Google Rich Results Test after deploying.
Detection
-
ID:
breadcrumb-list -
Severity:
high -
What to look for: Count all pages with hierarchical URLs containing at least 2 path segments (e.g.,
/products/category/item). For each, check for BreadcrumbList schema with anitemListElementarray where every level includesposition,name, anditem(URL). Verify at least 3 properties per ListItem element and that the breadcrumb hierarchy matches the URL structure. -
Pass criteria: At least 90% of pages with hierarchical URL structures include BreadcrumbList schema with complete
itemListElementarrays containingposition,name, anditemfor each level. Report: "X of Y hierarchical pages have BreadcrumbList schema." -
Fail criteria: Fewer than 90% of hierarchical pages have BreadcrumbList schema, or the breadcrumb list is incomplete (missing
position,name, oritemon any level). -
Skip (N/A) when: The site has a flat structure with no hierarchical URLs (all pages at one level, e.g.,
/about,/blog,/contact). -
Cross-reference: For overall site navigation structure and link depth, see the
page-reachabilitycheck in the Link Architecture category. -
Detail on fail:
"3 of 8 hierarchical pages lack BreadcrumbList schema"or"BreadcrumbList present but itemListElement array missing 'item' property on level 2". -
Remediation: BreadcrumbList schema helps search engines understand your site structure and enables breadcrumb Rich Results. Add it to hierarchical page components or in
app/[category]/[item]/page.tsx:{ "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://yoursite.com" }, { "@type": "ListItem", "position": 2, "name": "Products", "item": "https://yoursite.com/products" }, { "@type": "ListItem", "position": 3, "name": "Current Item", "item": "https://yoursite.com/products/item" } ] }
External references
- schema-org · BreadcrumbList — BreadcrumbList type with itemListElement
- schema-org · ListItem — ListItem with position, name, item properties
Taxons
History
- 2026-04-18·v1.0.0·Initial import from seo-advanced·automated