Component Blueprints

Breadcrumbs

information

You are currently viewing a sandbox preview version of Winter ’25 | Go back to Summer ’24

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#

The component styling hooks in this table are compatible with Lightning UI, but they aren’t compatible with Enhanced Lightning UI.

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.