Breadcrumbs

Breadcrumbs are a secondary navigation pattern that helps users keep track of their current location within a hierarchy. It provides a space-efficient means of allowing quick navigation to previous levels.

Example showing breadcrumbs.

Use the pattern when the user navigates through related pages, or drills down into tables or charts. It provides further navigation relative to a users workflow/selection within their current area, page or widget. They are especially useful for identifying a location in a hierarchy when the user lands on a page via deep-linking from search or an external source.

Low-fi header paired with Breadcrumbs.
Best practices
  • We recommend keeping the number of breadcrumb levels concise to a maximum of four, including the first level if it's displayed. Content is more easily discoverable when navigating a relatively wide and flat information hierarchy within applications. This prevents users from feeling overwhelmed.
  • Use breadcrumbs to complement the application's main navigation—never to replace it.
  • Don't show breadcrumbs when there is only one level in a hierarchy.

Breadcrumbs contain:

  1. Breadcrumb: Previous levels displayed as links icons separating them.
  2. Current level: A text label showing the user’s current location.
  3. Overflow menu: Use an overflow menu to show collapsed breadcrumbs.
Breadcrumbs anatomy
  • Use the Link component as the breadcrumb.
  • Use the chevron-right Icon as the separators.
  • Use the icon only menu button for the overflow menu trigger.
layout
layout
layout

Breadcrumbs can be collapsed to save space or hide lower priority levels (e.g. only displaying Home and the current level). The hidden levels can be revealed in 2 different ways:

Use an overflow menu when there is not enough horizontal space available, the order of the menu items should match the hierarchy of the levels.

Example showing collapsed breadcrumbs with an overflow menu.

Alternatively (if there is sufficient horizontal space), use an use an expansion button to reveal all levels. Showing the levels inline can make the hierarchy of the levels more visible.

Example showing collapsed breadcrumbs with expansion behavior.

Wrap breadcrumbs when there is a need to keep the breadcrumb trail visible in the app, breadcrumbs can wrap onto subsequent lines. The breadcrumb and its separator should be on the same line.

Example showing wrapped breadcrumbs

In some cases, you might want to hide breadcrumbs to make the path shorter or change breadcrumb labels to provide more context and help users understand the current task.

Example of shortened breadcrumbs. The levels “Settings” and “General” have been combined into one labelled “General Settings”.
Example of contextual breadcrumb labels. “Profile” has been changed to “Edit Profile”.

If you need to expand the pattern or share feedback with us, please contact the team.