BreadcrumbList Schema: Complete Reference

By Amit Patel

BreadcrumbList schema describes the navigational path to a page — Home › Category › Article — as an ordered list, which Google can display as a breadcrumb trail in place of the raw URL in search results. It is one of the few structured-data types that still reliably produces a visible enhancement, and it is simple: an ordered list of items, each with a position, name, and URL. The main pitfalls are duplication and mis-numbered positions.

What BreadcrumbList Does

It replaces the URL in a search result with a readable hierarchy, improving how the listing looks and reinforcing your site structure for Google.

The breadcrumb trail is both a user-facing enhancement and a structure signal — it tells Google how a page fits your hierarchy, complementing the internal linking and site architecture covered in the Technical SEO pillar. It is owned by Rank Math and most SEO plugins as one of the four foundational types, so hand-adding it usually duplicates.

The ItemList Structure

A BreadcrumbList contains an itemListElement array of ListItem objects, each with a position (starting at 1), a name, and an item URL — in the order a user would traverse from home to the current page.

Positions are sequential integers beginning at 1, and the order must match the actual navigational path. The current page can be the last item; some implementations omit its URL. This is the same ItemList pattern used by CollectionPage + ItemList, just applied to a navigation trail rather than a content list.

Common Ordering Bugs

The frequent errors are non-sequential or duplicate positions, a path that does not match the visible breadcrumb, and multiple BreadcrumbList blocks from a plugin plus a theme both emitting one.

Google reads positions literally — skip a number or repeat one and the breadcrumb can fail validation. And if your theme outputs breadcrumb markup while your SEO plugin also does, you get duplicates. Pick one source. Confirm the rendered trail matches the markup with the Rich Results Test.

Who Should Output It

Your SEO plugin (or a dedicated breadcrumbs plugin) should own it — it generates positions automatically from your hierarchy, which is more reliable than hand-numbering.

On this site, breadcrumbs are handled at the template level and Rank Math owns the BreadcrumbList JSON-LD, so content never hand-adds it — exactly the pattern to avoid the duplicate-schema problem shared with Article and Organization.

Example Markup

A two-level BreadcrumbList (shown as code):

<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": "Blog", "item": "https://example.com/blog/" }
  ]
}
</script>

See JSON-LD vs Microdata for the format rationale.

Frequently Asked Questions

The Bottom Line

BreadcrumbList is simple, still visible, and best left to a plugin: an ordered, correctly numbered path that matches your navigation. Keep a single source, verify positions, and it quietly improves how every deep page looks in search — part of the well-behaved foundation the schema cluster is built on.