Skip to main content

Components

Breadcrumb

Show the current page's place in a hierarchy with a list of links and a CSS-driven divider.

How it works

A breadcrumb is an ordered list inside a <nav>. The divider between items is generated by CSS from --bs-breadcrumb-divider, so it never ends up in the accessible name or the copied text. The theme's default divider is › (a single right-pointing angle quote) rather than Bootstrap's /.

Example

Mark the current page with .active and aria-current="page".

HTML
<nav aria-label="breadcrumb">
  <ol class="breadcrumb">
    <li class="breadcrumb-item active" aria-current="page">Home</li>
  </ol>
</nav>
<nav aria-label="breadcrumb">
  <ol class="breadcrumb">
    <li class="breadcrumb-item"><a href="#!">Home</a></li>
    <li class="breadcrumb-item active" aria-current="page">Library</li>
  </ol>
</nav>
<nav aria-label="breadcrumb">
  <ol class="breadcrumb">
    <li class="breadcrumb-item"><a href="#!">Home</a></li>
    <li class="breadcrumb-item"><a href="#!">Library</a></li>
    <li class="breadcrumb-item active" aria-current="page">Data</li>
  </ol>
</nav>
HTML
<nav aria-label="breadcrumb">
  <ol class="breadcrumb">
    <li class="breadcrumb-item"><a href="#!">Results</a></li>
    <li class="breadcrumb-item"><a href="#!">1991</a></li>
    <li class="breadcrumb-item"><a href="#!">Summer Spectacular</a></li>
    <li class="breadcrumb-item active" aria-current="page">Main event</li>
  </ol>
</nav>

Dividers

Change the divider by setting --bs-breadcrumb-divider on the .breadcrumb (or any ancestor). It takes anything valid in content: a quoted string, an embedded SVG, or '' to remove it.

HTML
<nav style="--bs-breadcrumb-divider: '>';" aria-label="breadcrumb">
  <ol class="breadcrumb">
    <li class="breadcrumb-item"><a href="#!">Home</a></li>
    <li class="breadcrumb-item active" aria-current="page">Library</li>
  </ol>
</nav>

The stock Bootstrap slash:

HTML
<nav style="--bs-breadcrumb-divider: '/';" aria-label="breadcrumb">
  <ol class="breadcrumb">
    <li class="breadcrumb-item"><a href="#!">Home</a></li>
    <li class="breadcrumb-item active" aria-current="page">Library</li>
  </ol>
</nav>

An embedded SVG chevron. Encode the # as %23 and quote the whole URL:

HTML
<nav style="--bs-breadcrumb-divider: url(&#34;data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='8' height='8'%3E%3Cpath d='M2.5 0L1 1.5 3.5 4 1 6.5 2.5 8l4-4-4-4z' fill='%235a73a8'/%3E%3C/svg%3E&#34;);" aria-label="breadcrumb">
  <ol class="breadcrumb">
    <li class="breadcrumb-item"><a href="#!">Home</a></li>
    <li class="breadcrumb-item active" aria-current="page">Library</li>
  </ol>
</nav>

Remove the divider with an empty string:

HTML
<nav style="--bs-breadcrumb-divider: '';" aria-label="breadcrumb">
  <ol class="breadcrumb">
    <li class="breadcrumb-item"><a href="#!">Home</a></li>
    <li class="breadcrumb-item active" aria-current="page">Library</li>
  </ol>
</nav>

To change the default for the whole site, set $breadcrumb-divider in Sass. The theme sets it to quote(›) in scss/_variables.scss. Set $breadcrumb-divider-flipped too if you compile an RTL build and the glyph has a direction.

$breadcrumb-divider: quote(›);     // theme default
$breadcrumb-divider: quote(">");
$breadcrumb-divider: none;         // no divider

Accessibility

  • Wrap the list in <nav aria-label="breadcrumb"> so it is announced as a navigation landmark.
  • Put aria-current="page" on the last item. The .active class only styles it.
  • Dividers are CSS-generated content and are not read aloud or copied.

CSS

All of Bootstrap's --bs-breadcrumb-* variables apply.

.breadcrumb {
  --bs-breadcrumb-padding-x: 0;
  --bs-breadcrumb-padding-y: 0;
  --bs-breadcrumb-margin-bottom: 1rem;
  --bs-breadcrumb-divider-color: var(--bs-secondary-color);   // navy-300 in light
  --bs-breadcrumb-item-padding-x: 0.5rem;
  --bs-breadcrumb-item-active-color: var(--bs-secondary-color);
}

.breadcrumb-item + .breadcrumb-item::before {
  content: var(--bs-breadcrumb-divider, "›");
}