Skip to the page content

Breadcrumbs

Show where a page sits and the way back up, from a plain trail to a folded one.

9 breadcrumb types

In a page header

The trail sits above the page title, so it reads as where the page lives before what it is. The title is the last level, so the trail stops one short of it.

HeaderBootstrap markup

Sculpted Shoulder Blazer

ML-BLAZ · $1,290.00 · 68 sold in the last 30 days

Show code
<nav aria-label="Breadcrumb">
  <ol class="breadcrumb mb-2">
    <li class="breadcrumb-item"><a href="products.html">Catalog</a></li>
    <li class="breadcrumb-item"><a href="categories.html">Tailoring</a></li>
    <li class="breadcrumb-item active" aria-current="page">Sculpted Shoulder Blazer</li>
  </ol>
</nav>
<header class="basalt-pagehead">
  <div class="basalt-pagehead-text">
    <h1 class="basalt-pagehead-title">Sculpted Shoulder Blazer</h1>
    <p class="basalt-pagehead-desc">ML-BLAZ · $1,290.00 · 68 sold in the last 30 days</p>
  </div>
  <div class="basalt-pagehead-actions">
    <a class="btn btn-outline-secondary btn-sm" href="#">View in store</a>
    <a class="btn btn-primary btn-sm" href="#">Edit product</a>
  </div>
</header>

Back link

A detail page opens with one step back instead of a trail. With data-basalt-back it works like the browser’s back button, and the link is the fallback when there is no history.

BackBasalt component
Back

Order #483

Faith van der Linden · Tiered Organza Dress × 2 · $3,360

Show code
<a class="basalt-hero-back" href="orders.html" data-basalt-back>
  <i class="bi bi-arrow-left" aria-hidden="true"></i>Back
</a>

Plain breadcrumb

Bootstrap’s breadcrumb in the palette: quiet links, a slash between levels and the current page in the text color. The last item is not a link.

PlainBootstrap markup
Show code
<nav aria-label="Breadcrumb">
  <ol class="breadcrumb">
    <li class="breadcrumb-item"><a href="#">Catalog</a></li>
    <li class="breadcrumb-item"><a href="#">Tailoring</a></li>
    <li class="breadcrumb-item active" aria-current="page">Draped Column Gown</li>
  </ol>
</nav>

Breadcrumb with icons

An icon in front of a level’s name, or on its own for Home with a hidden label for screen readers. One icon per trail is often enough.

IconsBootstrap markup
Show code
<ol class="breadcrumb">
  <li class="breadcrumb-item">
    <a href="#">
      <i class="bi bi-house-door me-0" aria-hidden="true"></i>
      <span class="visually-hidden">Home</span>
    </a>
  </li>
  <li class="breadcrumb-item"><a href="#"><i class="bi bi-receipt" aria-hidden="true"></i>Orders</a></li>
  <li class="breadcrumb-item active" aria-current="page">#483</li>
</ol>

Separators

The divider is one CSS property, --bs-breadcrumb-divider, set on the nav or on .breadcrumb. Slash is the default.

SeparatorsBootstrap markup

Slash

Chevron

Arrow

Dot

Show code
<nav class="breadcrumb-chevron" aria-label="Breadcrumb">
  <ol class="breadcrumb">…</ol>
</nav>

<!-- Or once for every trail, in your stylesheet -->
.breadcrumb { --bs-breadcrumb-divider: '→'; }

Collapsed trail

A deep trail keeps its first level and the last few, and folds the middle behind a button that opens the full trail. data-basalt-breadcrumb-max sets how many show.

CollapsedBasalt component
Three on show, then the default of four.
Show code
<nav aria-label="Breadcrumb">
  <ol class="breadcrumb basalt-breadcrumb-collapse" data-basalt-breadcrumb-max="3">
    <li class="breadcrumb-item"><a href="#">Catalog</a></li>
    <li class="breadcrumb-item"><a href="#">Clothing</a></li>
    <li class="breadcrumb-item"><a href="#">Tailoring</a></li>
    <li class="breadcrumb-item"><a href="#">Blazers</a></li>
    <li class="breadcrumb-item"><a href="#">Sculpted Shoulder Blazer</a></li>
    <li class="breadcrumb-item active" aria-current="page">Size M</li>
  </ol>
</nav>

<!-- Added after the page loads? Call window.basaltText(container). -->

Level with a menu

A level that opens a menu of its neighbors, so you can move to the next category without going up first. It is Bootstrap’s dropdown inside a breadcrumb item.

MenuBasalt component
Show code
<li class="breadcrumb-item">
  <div class="dropdown">
    <button type="button" class="basalt-breadcrumb-menu"
            data-bs-toggle="dropdown" aria-expanded="false">
      Tailoring<i class="bi bi-chevron-down" aria-hidden="true"></i>
    </button>
    <ul class="dropdown-menu">
      <li><a class="dropdown-item active" href="#" aria-current="true">Tailoring</a></li>
      <li><a class="dropdown-item" href="#">Dresses</a></li>
    </ul>
  </div>
</li>

In a card header

A short trail in place of a card title, with the card’s own action across from it. Handy for a folder or a category shown inside a page.

HeaderBootstrap markup
Edit
  • Cat-Eye Sunglasses$465.00
  • Two-Tone Oxfords$850.00
Show code
<div class="card">
  <div class="card-header d-flex align-items-center justify-content-between">
    <nav aria-label="Breadcrumb">
      <ol class="breadcrumb mb-0">
        <li class="breadcrumb-item"><a href="#"><i class="bi bi-folder2" aria-hidden="true"></i>Accessories</a></li>
        <li class="breadcrumb-item active" aria-current="page">Eyewear</li>
      </ol>
    </nav>
    <a class="btn btn-outline-secondary btn-sm" href="#">Edit</a>
  </div>
</div>

Compact on narrow screens

When its container is under 400px wide, the trail shows only the way up, as a back link to the level above. It follows the space it has, not the window. Drag the slider to try it.

CompactBasalt component
560px
Show code
<nav class="basalt-breadcrumb-compact" aria-label="Breadcrumb">
  <ol class="breadcrumb">
    <li class="breadcrumb-item"><a href="#">Catalog</a></li>
    <li class="breadcrumb-item"><a href="#">Dresses</a></li>
    <li class="breadcrumb-item active" aria-current="page">Chalk-Stripe Suit</li>
  </ol>
</nav>