# BreadcrumbList schema present on hierarchical pages

- **Pattern:** `ab-002484` (`seo-advanced.structured-data.breadcrumb-list`)
- **Severity:** high
- **Lifecycle:** active
- **Last modified:** 2026-04-18
- **Canonical URL:** https://auditbuffet.com/patterns/ab-002484
- **License:** CC-BY-4.0 — attribute to AuditBuffet Pattern Catalog (https://auditbuffet.com/patterns/ab-002484)

## 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`:

```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 an `itemListElement` array where every level includes `position`, `name`, and `item` (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 `itemListElement` arrays containing `position`, `name`, and `item` for 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`, or `item` on 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-reachability` check 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`:

  ```json
  {
    "@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
- schema-org ListItem

Taxons: findability

HTML version: https://auditbuffet.com/patterns/ab-002484