Loading...
Skip to main content

Breadcrumb

Indicate the current page's location within a navigational hierarchy using explicit divider elements.

Compose Breadcrumb, BreadcrumbItem, BreadcrumbLink, and BreadcrumbDivider inside a labelled navigation element. Use the item’s active prop to mark the current page; BreadcrumbLink also supports active when the link itself needs the current-page styling.

Example

Use an ordered list with BreadcrumbItem for each page and BreadcrumbDivider elements between them. Leave a divider empty to use the default chevron icon, or add your own separator content. Mark the current BreadcrumbItem as active.

<Stack gap={3}>
<nav aria-label="breadcrumb">
<Breadcrumb>
<BreadcrumbItem>
<BreadcrumbLink href="#">
Home
</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbDivider />
<BreadcrumbItem>
<BreadcrumbLink href="#">
Library
</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbDivider />
<BreadcrumbItem active>
<BreadcrumbLink href="#">
Data
</BreadcrumbLink>
</BreadcrumbItem>
</Breadcrumb>
</nav>
<nav aria-label="breadcrumb">
<Breadcrumb>
<BreadcrumbItem>
<BreadcrumbLink href="#">
Home
</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbDivider />
<BreadcrumbItem>
<BreadcrumbLink
aria-label="More pages"
href="#"
>
<Icon
aria-hidden
name="three-dots"
/>
</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbDivider />
<BreadcrumbItem>
<BreadcrumbLink href="#">
Documents
</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbDivider />
<BreadcrumbItem active>
<BreadcrumbLink href="#">
2026
</BreadcrumbLink>
</BreadcrumbItem>
</Breadcrumb>
</nav>
</Stack>

Dividers

Dividers are added explicitly using BreadcrumbDivider elements. An empty divider renders a default chevron, drawn with a CSS mask so it inherits the divider color (including in dark mode). To use a different separator, add your own content—any SVG icon, text character, or custom markup—which overrides the default.

Default divider

Leave the BreadcrumbDivider empty to get the built-in chevron. Customize it globally by overriding the --bs-breadcrumb-divider-icon, --bs-breadcrumb-divider-width, and --bs-breadcrumb-divider-height variables.

<Stack gap={3}>
<nav aria-label="breadcrumb">
<Breadcrumb>
<BreadcrumbItem>
<BreadcrumbLink href="#">
Home
</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbDivider />
<BreadcrumbItem active>
<BreadcrumbLink href="#">
Library
</BreadcrumbLink>
</BreadcrumbItem>
</Breadcrumb>
</nav>
</Stack>

SVG dividers

Add an inline SVG inside the divider to override the default with your own crisp, scalable icon. Use currentColor for the stroke or fill so it inherits the divider color for easy theming.

<Stack gap={3}>
<nav aria-label="breadcrumb">
<Breadcrumb>
<BreadcrumbItem>
<BreadcrumbLink href="#">
Home
</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbDivider>
<Icon
aria-hidden
name="chevron-double-right"
/>
</BreadcrumbDivider>
<BreadcrumbItem active>
<BreadcrumbLink href="#">
Library
</BreadcrumbLink>
</BreadcrumbItem>
</Breadcrumb>
</nav>
</Stack>

Text dividers

For simple text-based dividers, just add the character directly.

<Stack gap={3}>
<nav aria-label="breadcrumb">
<Breadcrumb>
<BreadcrumbItem>
<BreadcrumbLink href="#">
Home
</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbDivider>
/
</BreadcrumbDivider>
<BreadcrumbItem>
<BreadcrumbLink href="#">
Library
</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbDivider>
/
</BreadcrumbDivider>
<BreadcrumbItem active>
<BreadcrumbLink href="#">
Data
</BreadcrumbLink>
</BreadcrumbItem>
</Breadcrumb>
</nav>
</Stack>

Custom dividers

Use any content you like—different icons, decorative elements, or themed separators.

<Stack gap={3}>
<nav aria-label="breadcrumb">
<Breadcrumb>
<BreadcrumbItem>
<BreadcrumbLink href="#">
Home
</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbDivider>
›
</BreadcrumbDivider>
<BreadcrumbItem>
<BreadcrumbLink href="#">
Library
</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbDivider>
›
</BreadcrumbDivider>
<BreadcrumbItem active>
<BreadcrumbLink href="#">
Data
</BreadcrumbLink>
</BreadcrumbItem>
</Breadcrumb>
</nav>
</Stack>

Accessibility

Since breadcrumbs provide navigation, it’s important to follow these practices:

  • Give the navigation landmark an accessible name, such as aria-label="Breadcrumb".
  • Add aria-current="page" to the BreadcrumbItem containing the current page
  • Divider elements are automatically hidden from assistive technology via CSS

For more information, see the ARIA Authoring Practices Guide breadcrumb pattern.

CSS

Variables

Customize the component with the following local CSS variables. Override them through the wrapper’s style prop or your own CSS module.

CSS variableDefault
--bs-breadcrumb-font-sizeinherit
--bs-breadcrumb-bgtransparent
--bs-breadcrumb-border-radiusvar(--bs-radius-5)
--bs-breadcrumb-divider-colorvar(--bs-fg-4)
--bs-breadcrumb-divider-iconSVG mask image
--bs-breadcrumb-divider-width0.375rem
--bs-breadcrumb-divider-height0.75rem
--bs-breadcrumb-link-padding-x0.75rem
--bs-breadcrumb-link-padding-y0.25rem
--bs-breadcrumb-link-colorvar(--bs-fg-3)
--bs-breadcrumb-link-hover-colorvar(--bs-fg-2)
--bs-breadcrumb-link-hover-bgvar(--bs-bg-1)
--bs-breadcrumb-link-active-colorvar(--bs-fg-1)
--bs-breadcrumb-link-border-radiusvar(--bs-radius-7)
Documentation navigation
On this page
On this page