Skip to primary navigation Skip to main content
US flag signifying that this is a United States Federal Government website An official website of the United States Government USDA United State Department of Agriculture Farm Production and Conservation

Breadcrumbs

Overview

Provide hierarchical position within an application, and enable quick access through its levels.

<div class="fsa-breadcrumb">
  <nav class="fsa-breadcrumb__nav" aria-label="Breadcrumbs">
    <ul class="fsa-breadcrumb__list">
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">Home</a>
      </li>
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">Level 1</a>
      </li>
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">Level 2</a>
      </li>
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">Level 3</a>
      </li>
    </ul>
  </nav>
</div>

Examples

Breadcrumbs are typically paired with the <h1> page title. The following examples demonstrate how fsa-breadcrumb works in concert with the <h1> Page Title.

Single Item

Sports

<div class="fsa-breadcrumb">
  <nav class="fsa-breadcrumb__nav" aria-label="Breadcrumbs">
    <ol class="fsa-breadcrumb__list">
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">Home</a>
      </li>
    </ol>
  </nav>
</div>
<h1>Sports</h1>

Icons

Use any variety of Icons to heighten or clarify each Breadcrumb item.

<div class="fsa-breadcrumb">
  <nav class="fsa-breadcrumb__nav" aria-label="Breadcrumbs">
    <ol class="fsa-breadcrumb__list">
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">
          <svg class="fsa-icon fsa-icon--size-1" aria-hidden="true" focusable="false" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
            <path d="M10 20v-6h4v6h5v-8h3L12 3 2 12h3v8z"></path>
          </svg>
          Home
        </a>
      </li>
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">
          <svg class="fsa-icon fsa-icon--size-1" aria-hidden="true" focusable="false" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
            <path d="M10 4H4c-1.1 0-1.99.9-1.99 2L2 18c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V8c0-1.1-.9-2-2-2h-8l-2-2z"></path>
          </svg>
          Folder
        </a>
      </li>
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">
          <svg class="fsa-icon fsa-icon--size-1" aria-hidden="true" focusable="false" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
            <path d="M10 4H4c-1.1 0-1.99.9-1.99 2L2 18c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V8c0-1.1-.9-2-2-2h-8l-2-2z"></path>
          </svg>
          Folder
        </a>
      </li>
      <li class="fsa-breadcrumb__item" aria-current="page">
        <a href="/link.html" class="fsa-breadcrumb__link">
          <svg class="fsa-icon fsa-icon--size-1" aria-hidden="true" focusable="false" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
            <path d="M14 2H6c-1.1 0-1.99.9-1.99 2L4 20c0 1.1.89 2 1.99 2H18c1.1 0 2-.9 2-2V8l-6-6zm2 14h-3v3h-2v-3H8v-2h3v-3h2v3h3v2zm-3-7V3.5L18.5 9H13z"></path>
          </svg>
          New Document
        </a>
      </li>
    </ol>
  </nav>
</div>
<h1>Untitled Document</h1>

Reflect current page

Avoid using the same redundant label for the last crumb to reflect the current page, instead provide an alternate label that suffiently describes the page without being the same literal text.

In this example, the last crumb is indeed the current page - though with an alternate text label accurately describing the current page.

<div class="fsa-breadcrumb">
  <nav class="fsa-breadcrumb__nav" aria-label="Breadcrumbs">
    <ol class="fsa-breadcrumb__list">
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">Home</a>
      </li>
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">Farm Micro Authority</a>
      </li>
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">Inspections</a>
      </li>
      <li class="fsa-breadcrumb__item" aria-current="step">
        <a href="/link.html" class="fsa-breadcrumb__link">Inspection Detail</a>
      </li>
    </ol>
  </nav>
</div>
<h1>Inspection #1234</h1>

Reflect parent

When an alternate label (to the Page Title) cannot sufficiently describe the current page, then the last crumb shall reflect the current view’s immediate parent.

In this example the immediate parent, American League, acts as the last crumb to the current page, Kansas City Royals.

Kansas City Royals

<div class="fsa-breadcrumb">
  <nav class="fsa-breadcrumb__nav" aria-label="Breadcrumbs">
    <ol class="fsa-breadcrumb__list">
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">Home</a>
      </li>
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">Sports</a>
      </li>
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">Baseball</a>
      </li>
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">MLB</a>
      </li>
      <li class="fsa-breadcrumb__item">
        <a href="/link.html" class="fsa-breadcrumb__link">American League</a>
      </li>
    </ol>
  </nav>
</div>
<h1>Kansas City Royals</h1>

Usage

Use

  • For communicating hierarchy.
  • When the application structure is several levels deep.
  • When you want to allow the User to navigate quickly to various levels within the application architecture without using the browser back button.
  • When you want to help orient the User and provide contextual awareness within a process or application structure.

Don’t Use

  • In place of Global Navigation.
  • To display History.
  • To reflect a multi-step process. Use Stepped Tabs.
  • Within the page content as a hyperlink feature.
  • If the application is only one level deep or if the global navigation’s first level can be used.

General Guidance

  • Breadcrumbs are marked up an an Ordered List (<ol>) as its order matters.
  • Breadcrumbs should be located just below the global navigation system and above the main content of the application, typically immediately above the <h1> page title.
  • Keep each crumb’s title brief but descriptive.

Accessibility

  • Note the use of the <nav> element and aria attributes to describe the type of navigation.
Return to top