Breadcrumbs
Breadcrumbs are the trail of links that shows where a page sits in your site. They help visitors move up, help crawlers discover sections, and can show in search results. This page covers what to add, how to mark it up, how to check it, and the traps to avoid.
By Théophile Louvart, founder of Porteur · Updated 14 September 2026 · Markdown
What they do for a small site
Breadcrumbs give visitors a quick way back to a parent page. On a page like /guides/search-console/inspections, a trail like Home, Guides, Search Console, Inspections reduces pogoing to the main nav.
They add internal links up your hierarchy. That helps crawlers reach categories and hubs you care about, like /guides or /pricing.
With BreadcrumbList structured data, Google can replace the URL line under a result with the trail. That makes the path clearer on the results page and can lift confidence to click.
What to do on common page types
- Home: no breadcrumb needed, or show Home only and mark it current.
- Category or hub pages like /guides/: show Home, then the section, current unlinked.
- Articles and docs: include Home, section, and the subcategory if you have one.
- Product pages: show Home, Category, Product. For variants, keep the same trail.
- Search or filter pages: avoid breadcrumbs if the path is not a stable hierarchy.
A fixed page looks like this after changes: on /pricing for a SaaS, show Home, Pricing, with Pricing unlinked, and validate the two-item BreadcrumbList.
Traps to avoid
- Copying your header nav instead of the real hierarchy.
- Linking the current page in the trail, which confuses assistive tech.
- Letting CMS tags create multiple, conflicting paths for one page.
- Using spans for everything, not an ordered list, so the order is unclear.
- Stuffing keywords into crumb names that do not match the page titles.
- Breaking canonicals and trails: if a page is canonical, its breadcrumb should reflect that canonical location.
Questions
It is the trail of links that shows where a page sits in your site, such as Home, Guides, Search Console, this page. It helps users move up and gives crawlers internal links to parents.
On /docs/getting-started, you might show Home, Docs, Getting started. The last item is the current page and should not be a link.
Some themes show a path that mirrors folders in the URL. That can be fine, but the better rule is to mirror your actual site structure, which is not always the same as the URL.
They add clear internal links and can replace the URL line in search with a trail when marked up as BreadcrumbList. That can improve how your result reads and how crawlers move.
Maps uses a different interface. Breadcrumbs are a website pattern for page navigation and structured data for web search results, not map directions.
Place them near the top of the main content area, before the h1 or just after, so users and assistive tech reach them early. Keep the pattern consistent across pages.
Sources
Check my site, free
Paste a URL and get a free check that reads your site and the searches around it, then shows three breadcrumb findings in about thirty seconds.
- Free check, no card
- Read-only, your own accounts
- Readable by your agent
Read next
- GuideBreadcrumbs: the navigation, the markup, and what Google shows
- GlossaryStructured data
- GlossaryInternal link
- GuideInternal linking for a small site: which pages link to which
- Free toolStructured data checker
- GuideJSON-LD: how to write it, where to put it, how to test it
- GuideSEO for sites built with AI app builders: Lovable, Bolt, v0 and Replit
- GuideCaching: what to cache, for how long, and what it does for crawling