Breadcrumb

Shows the current location in a navigation hierarchy.

When to use

Use breadcrumbs to show a page’s position within a hierarchy and provide links to its ancestors. Keep primary destinations in the Navbar; breadcrumbs describe the current location.

Default

HTML
<nav aria-label="Breadcrumb">
	<ol class="breadcrumb">
		<li class="breadcrumb-item"><a href="/">Home</a></li>
		<li class="breadcrumb-item is-active" aria-current="page">Library</li>
	</ol>
</nav>

Current page and hierarchy

The final item represents the current page. Add intermediate ancestor links between Home and that item for deeper hierarchies; keep only the current item marked with aria-current="page".

Accessibility and behavior

  • Use a labelled nav and an ordered list in parent-to-child order. Different navigation landmarks should have distinct accessible names.
  • Mark the current page with aria-current="page" and visible text. Ancestors are ordinary links with meaningful destinations.
  • Separators are decorative. Preserve link focus indicators and allow long labels to wrap without hiding hierarchy information.

CSS variables

Override these base defaults on the listed selector after the library styles. Variants and states may replace them; global tokens follow the active theme.

TokenDefaultPurposeScope / state
--breadcrumb-padding-xvar(--spacer-0)Left and right padding..breadcrumb
--breadcrumb-padding-yvar(--spacer-0)Top and bottom padding..breadcrumb
--breadcrumb-divider-colorvar(--text-subtle)Separator color..breadcrumb
--breadcrumb-item-padding-xvar(--spacer-2)Space on either side of a separator..breadcrumb
--breadcrumb-item-active-colorvar(--text-muted)Current breadcrumb text color..breadcrumb