Component Blueprints

Breadcrumbs

Use breadcrumbs to note the path of a record and help the user to navigate back to the parent.

About Breadcrumbs#

Breadcrumbs are typically constructed with an ol because their order matters. You mark up breadcrumbs with classes from the horizontal list utility. When you add the slds-breadcrumb class, the separators are automatically generated.

Accessibility#

Place the breadcrumb in a nav element with role="navigation". The nav element is also marked-up with aria-label="Breadcrumbs" to describe the type of navigation.

Base#

<nav role="navigation" aria-label="Breadcrumbs">
  <ol class="slds-breadcrumb slds-list_horizontal slds-wrap">
    <li class="slds-breadcrumb__item">
      <a href="#">Parent Entity</a>

Variations#

With Overflow#

The overflow menu breadcrumbs variant is a composition of the overflow menu with actions example of the menus component and breadcrumbs component. To implement this, include the overflow menu as the first <li> in the breadcrumb component. In order to vertically align all of the breadcrumb items to the center, add the slds-grid_vertical-align-center class to the <ol>.

<nav role="navigation" aria-label="Breadcrumbs">
  <ol class="slds-breadcrumb slds-list_horizontal slds-wrap slds-grid_vertical-align-center">
    <li class="slds-breadcrumb__item">
      <div class="slds-dropdown-trigger slds-dropdown-trigger_click slds-is-open">

Styling Hooks Overview#

Use these CSS Custom Properties as hooks to customize this SLDS component with your own style. For more information, read the technical documentation.

CategoryStyling Hook NameValue Type(s)Fallback Value
Spacing
--slds-c-breadcrumbs-spacing-inline-end
Dimension0.5rem
--slds-c-breadcrumbs-spacing-inline-start
Dimension0.5rem

Overview of CSS Classes#

Selector.slds-breadcrumb
Summary

Create breadcrumbs component

Supportdev-ready
Restrictol
VariantTrue
Selector.slds-breadcrumb__item
Summary

Item of the breadcrumb list

Restrict.slds-breadcrumb li

Breadcrumbs Release Notes

2.17.0

Added

  • Added slds as the default namespace with sds fallbacks for Styling Hooks.

2.15.0

  • Added Kinetic styles and demo functionality for Breadcrumbs

2.13.0

  • Enabled styling hooks for breadcrumb. See breadcrumb's styling hooks overview table for a full listing of the currently available hooks.

2.8.4

Fixed

  • Adjusted typographic styling for breadcrumb items.

2.8.0

Changed

  • Added bold font weight to '.slds-breadcrumb__item`.

Removed

  • Removed .slds-text-title_caps from breadcrumb list item.