Breadcrumb
Trail hierarchy without the busywork — separators appear on their own, long trails collapse themselves, and chevrons mirror in RTL.
Installation#
pnpm dlx shadcn@latest add @davinciui/breadcrumbUsage#
The list owns the separators: write only items and chevrons appear between them. Pass separator for a custom mark, maxItems to collapse long trails behind an expander, or drop in explicit BreadcrumbSeparator rows for full manual control.
Breadcrumb
└── BreadcrumbList
├── BreadcrumbItem → BreadcrumbLink
└── BreadcrumbItem → BreadcrumbPageComposition#
Use the following composition to build a Breadcrumb:
Breadcrumb
└── BreadcrumbList
├── BreadcrumbItem
│ ├── BreadcrumbLink
│ └── BreadcrumbPage
├── BreadcrumbSeparator
└── BreadcrumbEllipsisAPI Reference#
| Prop | Type | Default |
|---|---|---|
separatorMark rendered between items. Null disables (BreadcrumbList). | ReactNode | null | chevron |
maxItemsCollapse the middle rows behind a counted expander. | number | — |
asChildAdopt your router link (BreadcrumbLink). | boolean | false |
aria-labelLandmark label on the nav root. | string | "breadcrumb" |
aria-currentMarks the current row (BreadcrumbPage). | "page" | "page" |
classNameAdditional CSS classes on any part. | string | — |
Accessibility#
The nav is labelled 'breadcrumb', items are list entries, separators are presentation-only, and the current page uses aria-current='page'. The collapse expander is a button with a count label, though its aria-expanded stays false after expanding.
Motion#
Motion is limited to color transitions on links and the expander; separators and layout do not animate. No prefers-reduced-motion handling is needed or present.
View source
Keep in mind
Need a custom component?
I build bespoke UI components & websites tailored to your brand.

