3.0.1

Components

Breadcrumb

Shows where the current page sits in the hierarchy.

Installation

npx shadcn@latest add @blank/breadcrumb

Usage

import {
  Breadcrumb,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbList,
  BreadcrumbPage,
  BreadcrumbSeparator,
} from "@/components/ui/breadcrumb"
<Breadcrumb>
  <BreadcrumbList>
    <BreadcrumbItem>
      <BreadcrumbLink href="/">Home</BreadcrumbLink>
    </BreadcrumbItem>
    <BreadcrumbSeparator />
    <BreadcrumbItem>
      <BreadcrumbPage>Settings</BreadcrumbPage>
    </BreadcrumbItem>
  </BreadcrumbList>
</Breadcrumb>

The list renders as nav > ol > li, and separators are list items marked role="presentation", so screen readers announce the trail as a list of links.

Examples

Separator

variant="slash" swaps the chevron for a slash, the usual choice for repository and project paths.

Collapsed

Long trails collapse the middle into BreadcrumbEllipsis, which is a real button, so it can open a menu of the hidden pages.

Sizes