Breadcrumb Schema: BreadcrumbList Markup That Matches Your Site
Breadcrumb schema is BreadcrumbList structured data: the trail of pages from a top section down to the page you are on. Google can show that trail in place of the URL in a desktop result. It is one of the simplest types to write, with three properties on each item, and one of the easiest to get subtly wrong across thousands of pages. Verified against Google's documentation on November 21, 2026.
What Breadcrumb Schema Does
A breadcrumb trail shows where a page sits in a site: Shoes > Trail Running > TR2. Google's breadcrumb documentation says it uses BreadcrumbList markup in the body of a page to categorize the information on the page in search results. In a result, the trail can replace the plain URL line.
It helps people too: a trail on the page lets a visitor jump one level up, and it adds a set of internal links to parent pages on every page that carries it.
Desktop Only Since January 2025
On January 22, 2025, Google updated the breadcrumb documentation to say breadcrumbs appear in desktop results only. Google gave the reason: breadcrumbs get cut short on small screens, so the feature was less useful to people searching on phones.
| Where | Breadcrumb in results | Since |
|---|---|---|
| Desktop | ✓ | Still shown |
| Mobile | – | Jan 22, 2025 |
| Regions and languages | All | Desktop |
Google did not ask anyone to remove the markup. It still describes the structure of the site, and desktop searches still use it.
BreadcrumbList Properties at a Glance
Google's list is short. There are no recommended properties, only required ones.
| Type | Property | Status | Expects |
|---|---|---|---|
| BreadcrumbList | itemListElement | Required | 2 or more ListItem |
| ListItem | position | Required | Integer, 1 = start |
| ListItem | name | Required | Label shown to users |
| ListItem | item | Required, not on last | URL of that level |
| Any | Recommended properties | 0 listed | None |
Two details from the documentation that change how you write it:
- The last item needs no URL. If
itemis left out of the last ListItem, Google uses the URL of the page itself. - Home and the current page are optional. You do not need a ListItem for the top level or for the page you are on.
A Valid Breadcrumb Schema JSON-LD Example
A product page three levels deep. The last item has a name and no URL:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Shoes",
"item": "https://www.example.com/shoes/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Trail Running",
"item": "https://www.example.com/shoes/trail-running/"
},
{
"@type": "ListItem",
"position": 3,
"name": "Trail Running Shoe TR2"
}
]
}
</script>
A page can carry more than one trail when it really sits in two places, for example a book listed under two genres. Each trail is its own BreadcrumbList:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Books",
"item": "https://www.example.com/books/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Science Fiction",
"item": "https://www.example.com/books/sci-fi/"
}
]
}
</script>
Google asks that the trail represent a typical path a user could take to the page, not the folders of the URL. A URL like /p/48213 can still have a full trail.
The Visible Trail That Goes With It
The markup describes a trail people can see. Print both from the same data, so a renamed category changes in both places at once. The visible trail for the first example above:
<nav aria-label="Breadcrumb">
<ol>
<li><a href="https://www.example.com/shoes/">Shoes</a></li>
<li><a href="https://www.example.com/shoes/trail-running/">Trail Running</a></li>
<li><a href="https://www.example.com/shoes/trail-running/tr2" aria-current="page">Trail Running Shoe TR2</a></li>
</ol>
</nav>
Three things make this trail work for everyone:
- A nav element with a label, so assistive technology announces it as breadcrumb navigation.
- An ordered list, because the order is the meaning.
aria-current="page"on the current page, whether it is a link or plain text.
The labels in the visible trail and the name values in the markup should match word for word. If the visible trail is shortened on small screens, the markup can still hold the full trail.
Common Breadcrumb Schema Mistakes
| Mistake | Effect | Fix |
|---|---|---|
| Only 1 ListItem | Below the minimum of 2 | Add the parent level |
| position starts at 0 | Order off by one | Start at 1 |
| Positions repeat or skip | Order unclear | Number 1, 2, 3 |
| item URL redirects | Points to an old URL | Use the final URL |
| item URL is noindex | Trail to a hidden page | Link indexable parents |
| Markup differs from visible trail | Misleading markup | Print both from one source |
| Relative URLs in item | Ambiguous level URL | Use absolute URLs |
The redirect and noindex rows only show up across a crawl: the markup is valid JSON, but the URLs inside it lead somewhere they should not. SEO ProCheck's BreadcrumbList schema check lists the details it tests.
Breadcrumbs, Click Depth and Internal Links
A breadcrumb trail on the page is also a row of internal links, and that row is on every page of a template. On a large site, it is often what keeps parent categories within a few clicks of everything below them.
| Effect of a visible trail | Without | With |
|---|---|---|
| Links to parent levels | Often 0 | 1 per level |
| Way up for visitors | Back button | One click |
| Category pages linked from | Menus only | Every child page |
Mark the current page in the visible trail with aria-current="page" so screen readers announce it, and keep the markup and the visible trail identical. The internal linking guide covers how link structure shapes which pages crawlers reach first.
How to Check Breadcrumb Schema Across a Site
- Crawl the whole site, rendered if your trail is built by JavaScript.
- List pages without BreadcrumbList in templates where most pages have it.
- Check each trail: at least 2 items, positions from 1, names present, URLs on all but the last.
- Fetch the URLs in the trails. Every level should answer 200 and be indexable.
- Compare with the visible trail, label by label.
- Look at Search Console for breadcrumb errors after a release.
The schema markup validator guide explains why one page at a time is not enough for template markup like this.
Check Breadcrumb Schema With Neova
Neova reads JSON-LD, microdata and RDFa from every HTML page of a crawl and gives each type on a URL a verdict. For breadcrumbs:
- Structured Data Lacks Required Properties or Differs From Visible Text, for features Google documents
- Structured Data Has Syntax Errors
- HTML Page Lacks Rich Result Markup Its Page Group Carries, when half or more of a page group carry a type and some pages do not
- Structured Data Type Common in Its Page Group Is Missing
- Link to the Current URL in Navigation or Breadcrumbs Lacks Aria-Current
- Indexable URL Is at Crawl Depth 4 or More, for pages a trail could bring closer
The Free plan crawls up to 1,000 URLs with every check, on Mac, Windows and Linux. See Features or download Neova.
Questions
Does Google still show breadcrumbs in search results?
On desktop, yes, in all regions and languages. Since January 22, 2025, Google no longer shows them in mobile results, because the trail was cut short on small screens.
What are the required properties for breadcrumb schema?
itemListElement on BreadcrumbList with at least two ListItems, and position, name and item on each ListItem. The last ListItem can leave out item.
Should the breadcrumb include the home page?
It can, but Google does not require it, and it does not require an item for the current page either. Keep the markup the same as the trail visitors see.
Can a page have more than one breadcrumb trail?
Yes. If a page sits in two places in your site, add one BreadcrumbList per trail. Each must still be a path a visitor could really take.
Does breadcrumb schema need to match the URL?
No. Google asks for a typical user path to the page, not a copy of the URL folders. A short or numeric URL can have a full trail.