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 theBreadcrumbItemcontaining 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 variable | Default |
|---|---|
--bs-breadcrumb-font-size | inherit |
--bs-breadcrumb-bg | transparent |
--bs-breadcrumb-border-radius | var(--bs-radius-5) |
--bs-breadcrumb-divider-color | var(--bs-fg-4) |
--bs-breadcrumb-divider-icon | SVG mask image |
--bs-breadcrumb-divider-width | 0.375rem |
--bs-breadcrumb-divider-height | 0.75rem |
--bs-breadcrumb-link-padding-x | 0.75rem |
--bs-breadcrumb-link-padding-y | 0.25rem |
--bs-breadcrumb-link-color | var(--bs-fg-3) |
--bs-breadcrumb-link-hover-color | var(--bs-fg-2) |
--bs-breadcrumb-link-hover-bg | var(--bs-bg-1) |
--bs-breadcrumb-link-active-color | var(--bs-fg-1) |
--bs-breadcrumb-link-border-radius | var(--bs-radius-7) |