Breadcrumbs

A trail back up the hierarchy, one hop at a time.

v1.0.0·Updated Jul 10, 2026 · 23:00
Live Demo — Fully Interactive
A working trail — click any crumb to navigate up to it
Configuration
Separator
Icons
Sibling menus
Overflow
<Breadcrumbs separator="chevron" />
Behavior — The Engineering Contract
PropTypeNotes
Item href / currentstring / booleanLink, or the non-clickable current page
maxItemsnumberCollapse the middle into a … dropdown past this
separatorchevron · slash · arrow · dotGlyph between crumbs
siblingMenusbooleanA caret on each crumb opens its sibling pages
showIconsbooleanLeading home / folder glyphs
aria-currentpageSet on the last crumb for assistive tech

Breadcrumbs show where a page sits in the hierarchy. For switching peer views use Tabs; for primary wayfinding use the nav.

Anatomy
1CrumbA link to an ancestor page.
2SeparatorMuted chevron between the crumbs.
3CurrentThe page you are on; bold, not a link.
Do's and Don'ts
✓ Do

Mark the current page as bold and non-clickable.

✕ Don't

Don't print a deep path in full. Collapse the middle to a … menu.

✓ Do

Keep the first and last, collapse the rest behind a … dropdown.

✕ Don't

Don't let one crumb sprawl. Truncate it with an ellipsis.

In context: Examples
A · Page header

Above a page title, showing where you are.

B · File path

A file or folder path in an editor or browser.

C · Collapsed

A deep hierarchy kept to one honest line.

Measurements & Tokens
TokenValueRole
--bc-item#9AA0A8Crumb link colour
--bc-current#F4F5F6Current page, weight 500
--bc-sep#3A3C42Separator glyph
--bc-hoverrgba(255,255,255,.04)Crumb hover fill
--bc-trunc150pxMax width before a crumb truncates
--bc-radius6pxCrumb hit-area corner
Code
<nav class="o-bc" aria-label="Breadcrumb">
  <a class="o-bc__item" href="/">Home</a>
  <span class="o-bc__sep">›</span>
  <a class="o-bc__item" href="/components">Components</a>
  <span class="o-bc__sep">›</span>
  <span class="o-bc__item is-current" aria-current="page">Avatar</span>
</nav>