---
title: Breadcrumb schema: BreadcrumbList JSON-LD example and rules
description: How to add BreadcrumbList structured data: a copy ready JSON-LD example, the required properties, the desktop only display change and mistakes that break it.
canonical: https://www.postbing.com/blog/breadcrumb-schema-guide
published: 2026-11-16
updated: 2026-11-16
author: The Postbing Team
---

# Breadcrumb schema: BreadcrumbList JSON-LD example and rules

Breadcrumb schema is BreadcrumbList structured data that describes where a page sits in your site, for example Home, then Blog, then Category, then the article. Google requires an `itemListElement` array of `ListItem` entries, each with `position`, `name` and `item` (the URL, optional on the last entry). Since January 2025, Google shows breadcrumbs in results on desktop only.

Last updated: November 16, 2026

## What does breadcrumb schema do in 2026?

It tells Google the page's place in your site and can replace the raw URL in a desktop search result with a readable trail. Google's breadcrumb documentation (updated 8 September 2026) says the feature "is available on desktop in all regions and languages where Google Search is available." Google's documentation was updated on 22 January 2025 to say breadcrumbs only appear in desktop results, not mobile, so on phones the trail is not shown.

In the [technical SEO for AI search checklist](/blog/technical-seo-for-ai-search-checklist) breadcrumbs sit with the other structured data, after access and rendering are fixed.

Beyond the display, breadcrumbs state your site structure in a form any parser can read: which category a page belongs to and what the parent pages are. That mirrors the internal links a reader sees, which is the part that helps crawlers find and group your pages. Our [internal linking strategy guide](/blog/internal-linking-strategy-guide) covers the linking side.

## What properties are required?

BreadcrumbList has one required property and ListItem has three. This is the full list from Google's documentation:

| Object | Property | Required? | Notes |
|---|---|---|---|
| BreadcrumbList | itemListElement | Yes | An array of ListItem entries, one per level |
| ListItem | position | Yes | Integer, starting at 1 for the top level |
| ListItem | name | Yes | The label a user sees, such as "Blog" |
| ListItem | item | Yes, except on the last item | The URL of that level; Google says the last item does not need it |

Google lists no recommended properties beyond these, which makes breadcrumbs one of the simplest types to get right.

## A copy ready JSON-LD example

This trail is for a blog article that sits in a category. Positions count from 1, each level links to a real page, and the last item (the current page) has no `item`, which Google allows.

```html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com/" },
    { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://www.example.com/blog" },
    { "@type": "ListItem", "position": 3, "name": "Technical SEO", "item": "https://www.example.com/blog/category/technical-seo" },
    { "@type": "ListItem", "position": 4, "name": "How to fix crawled, currently not indexed" }
  ]
}
</script>
```

The visible breadcrumb on the page should show the same trail with the same labels:

```html
<nav aria-label="Breadcrumb">
  <ol>
    <li><a href="/">Home</a></li>
    <li><a href="/blog">Blog</a></li>
    <li><a href="/blog/category/technical-seo">Technical SEO</a></li>
    <li aria-current="page">How to fix crawled, currently not indexed</li>
  </ol>
</nav>
```

Generate both from the same data in your template, so a renamed category updates the markup and the visible links together.

## Should breadcrumbs follow the URL or the user path?

Follow the user path. Google says: "We recommend providing breadcrumbs that represent a typical user path to a page, instead of mirroring the URL structure." A flat URL like `/blog/breadcrumb-schema-guide` can still have a four level trail through its category, because that is how a reader reaches it.

Two practical consequences:

- **Category pages must exist.** Every level with an `item` should be a real, indexable page that returns 200. A trail pointing at a category URL that 404s is worse than a shorter trail.
- **Pick one primary category.** If a post is tagged in five categories, choose the one a reader would browse through and use it consistently.

## Can a page have more than one breadcrumb trail?

Yes. Google says: "If there are multiple ways to navigate to a page on your site, you can specify multiple breadcrumb trails for a single page." An online shop might reach the same product through "Women, Shoes, Running" and through "Sale, Running". Add one BreadcrumbList per trail, either as separate script tags or as an array:

```json
[
  { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ ... ] },
  { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ ... ] }
]
```

For a blog, one trail is almost always enough. Multiple trails make sense when the site genuinely has two navigation routes to the page.

## Common mistakes

Most breadcrumb errors come from templates, not from people. Check for these:

1. **Positions that do not start at 1 or skip a number.** Use 1, 2, 3 in order.
2. **Relative URLs in `item`.** Use full URLs with the protocol and the same host as your canonical (www or not).
3. **A trail that disagrees with the visible breadcrumb.** If the page shows "Home, Guides" but the markup says "Home, Blog, Technical SEO", fix the template so both come from one source.
4. **Home linking to a different host.** If your canonical is ` the Home item must not be `
5. **Markup injected by JavaScript.** Crawlers that do not run scripts never see it. Keep JSON-LD in the server HTML.

To check what crawlers receive:

```bash
curl -s https://www.example.com/blog/your-post | grep -o '"@type": *"ListItem"' | wc -l
```

The number should equal the number of levels in your trail. Then run the page through Google's Rich Results Test and the URL Inspection tool to see how Google reads it.

## How breadcrumbs fit with other schema

On an article page you would normally have three blocks: Article (or BlogPosting), BreadcrumbList and, if there is an FAQ, FAQPage. They can sit in separate script tags or in one `@graph`. The [Article schema guide](/blog/article-schema-json-ld-guide) has the article block and [FAQ schema in 2026](/blog/faq-schema-guide) explains why the FAQ block no longer earns a rich result. The [technical SEO for AI search checklist](/blog/technical-seo-for-ai-search-checklist) puts structured data after access, rendering and canonicals in the order of work. If you are choosing where your blog lives, [hosted blog vs subfolder vs subdomain](/blog/hosted-blog-vs-subfolder-vs-subdomain) affects what your Home and Blog levels point to. For how Postbing structures the articles it publishes, start at the [home page](/).

## FAQ

### Does Google still show breadcrumbs in search results?
Yes, on desktop. Google's documentation says the feature is available on desktop in all regions and languages where Google Search is available. Since a January 2025 update, they do not appear in mobile results.

### Is the item URL required on the last breadcrumb?
No. Google says that if the breadcrumb is the last item in the trail, item is not required. Position and name are still required.

### Should breadcrumb schema match my URL structure?
Not necessarily. Google recommends breadcrumbs that represent a typical user path to the page instead of mirroring the URL structure.

### Can I have two breadcrumb trails on one page?
Yes. Google says you can specify multiple breadcrumb trails when there are multiple ways to navigate to a page.

### Do I need visible breadcrumbs as well as the schema?
Yes, the markup should describe a trail users can see. Generate both from the same template data so they always match.

## Sources

- [Google Search Central, Breadcrumb structured data](https://developers.google.com/search/docs/appearance/structured-data/breadcrumb): required properties, last item rule, user path advice, multiple trails, desktop availability, page updated 8 September 2026, accessed 16 November 2026
- [Google Search Central, documentation updates](https://developers.google.com/search/updates): 22 January 2025 entry making breadcrumbs desktop only, accessed 16 November 2026
- [Schema.org, BreadcrumbList](https://schema.org/BreadcrumbList): type definition, accessed 16 November 2026

## Related reading

- [Technical SEO for AI search: the full checklist](/blog/technical-seo-for-ai-search-checklist)
- [Article schema in JSON-LD](/blog/article-schema-json-ld-guide)
- [FAQ schema in 2026](/blog/faq-schema-guide)
- [Internal linking strategy guide](/blog/internal-linking-strategy-guide)
- [How Postbing structures and publishes articles](/)
