Breadcrumbs
The path from a section down to the current page, as links with chevrons between them. The last item is the current page and is not a link.
Usage
Use it when
- A page sits three or more levels deep in a hierarchy people need to climb back up: Academics, Courses, Database Systems.
- People land on deep pages from search or a shared link and need to see where they are.
Use something else when
- A single step back on a phone screen: use Phone bars. Use the nav bar back button.
- Progress through an ordered flow (registration, checkout): use Steps.
- The main navigation of the app: use App shell.
- A flat site with two levels: use Top nav. The current link in the nav already says where you are.
Where it goes. At the very top of the content, above the page title, as the first line of the page header. Never inside the top bar or the sidebar. On phones keep it if it fits in two lines; otherwise show only the parent with a chevron_left back link.
Examples
<nav aria-label="Breadcrumb">
<ol class="crumbs">
<li><a href="#bc">Academics</a></li>
<li><span class="ic" aria-hidden="true">chevron_right</span></li>
<li><a href="#bc">Courses</a></li>
<li><span class="ic" aria-hidden="true">chevron_right</span></li>
<li><span aria-current="page">Database Systems</span></li>
</ol>
</nav><nav aria-label="Breadcrumb">
<ol class="crumbs">
<li><a href="#bc" aria-label="Home"><span class="ic" aria-hidden="true">home</span></a></li>
<li><span class="ic" aria-hidden="true">chevron_right</span></li>
<li><a href="#bc">Tryouts</a></li>
<li><span class="ic" aria-hidden="true">chevron_right</span></li>
<li><a href="#bc">Civil service basics</a></li>
<li><span class="ic" aria-hidden="true">chevron_right</span></li>
<li><span aria-current="page">Result of tryout 4</span></li>
</ol>
</nav>Anatomy
| Part | What it is |
|---|---|
nav[aria-label="Breadcrumb"] | Required. The landmark around the list. |
ol.crumbs | Required. The ordered list; wraps onto more lines when narrow. |
li > a | An ancestor page; quiet text with a tint on hover. |
li > .ic | A chevron_right separator in its own <li>, aria-hidden. |
li > span[aria-current="page"] | Required. The current page: strong text, not a link. |
States
| State | How |
|---|---|
hover | The link darkens to strong text on a quiet tint over --d-fast. |
focus | System focus ring on the link. |
aria-current="page" | Strong text at weight 500, no hover, not focusable. |
Motion and microinteractions
- Only color and background ease, over
--d-fast(160 ms). Nothing moves.
Accessibility
- A
<nav aria-label="Breadcrumb">around an<ol>, so screen readers announce "list, 3 items" in order. - Separators are
aria-hiddenicons; the current page is a<span aria-current="page">. - An icon-only crumb needs an
aria-label.
Do and don't
Do
- Mirror the real hierarchy, not the history of where the person clicked.
- Use the same names as the page titles they point to.
Don't
- Link the current page to itself.
- Use breadcrumbs as the only way back on phones; the back button comes first.
- Truncate the middle with an ellipsis menu for fewer than five levels.