Breadcrumb
Displays the current page location within a navigational hierarchy.
Introduction
Breadcrumbs indicate the current page's location within a navigational hierarchy. They automatically add separators between items using CSS and support custom separator elements.
Installation
import {
Breadcrumb,
BreadcrumbList,
BreadcrumbItem,
BreadcrumbLink,
BreadcrumbPage,
BreadcrumbSeparator,
BreadcrumbEllipsis,
} from '@/components/ui/breadcrumb';Usage
<Breadcrumb>
<BreadcrumbList>
<BreadcrumbItem>
<BreadcrumbLink href="/">Home</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbSeparator />
<BreadcrumbItem>
<BreadcrumbPage>Current Page</BreadcrumbPage>
</BreadcrumbItem>
</BreadcrumbList>
</Breadcrumb>Examples
Default
import {
Breadcrumb, BreadcrumbList, BreadcrumbItem,
BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator,
} from '@/components/ui/breadcrumb';
export default function Component() {
return (
<Breadcrumb>
<BreadcrumbList>
<BreadcrumbItem><BreadcrumbLink href="#">Home</BreadcrumbLink></BreadcrumbItem>
<BreadcrumbSeparator />
<BreadcrumbItem><BreadcrumbLink href="#">Components</BreadcrumbLink></BreadcrumbItem>
<BreadcrumbSeparator />
<BreadcrumbItem><BreadcrumbPage>Breadcrumb</BreadcrumbPage></BreadcrumbItem>
</BreadcrumbList>
</Breadcrumb>
);
}Custom Separator
Use the children prop on BreadcrumbSeparator to customize the divider.
import { Slash } from 'lucide-react';
import {
Breadcrumb, BreadcrumbList, BreadcrumbItem,
BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator,
} from '@/components/ui/breadcrumb';
export default function Component() {
return (
<Breadcrumb>
<BreadcrumbList>
<BreadcrumbItem><BreadcrumbLink href="#">Home</BreadcrumbLink></BreadcrumbItem>
<BreadcrumbSeparator><Slash className="size-3.5" /></BreadcrumbSeparator>
<BreadcrumbItem><BreadcrumbLink href="#">Components</BreadcrumbLink></BreadcrumbItem>
<BreadcrumbSeparator><Slash className="size-3.5" /></BreadcrumbSeparator>
<BreadcrumbItem><BreadcrumbPage>Breadcrumb</BreadcrumbPage></BreadcrumbItem>
</BreadcrumbList>
</Breadcrumb>
);
}With Ellipsis
Use BreadcrumbEllipsis to indicate collapsed breadcrumb items.
import {
Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink,
BreadcrumbPage, BreadcrumbSeparator, BreadcrumbEllipsis,
} from '@/components/ui/breadcrumb';
export default function Component() {
return (
<Breadcrumb>
<BreadcrumbList>
<BreadcrumbItem><BreadcrumbLink href="#">Home</BreadcrumbLink></BreadcrumbItem>
<BreadcrumbSeparator />
<BreadcrumbItem><BreadcrumbEllipsis /></BreadcrumbItem>
<BreadcrumbSeparator />
<BreadcrumbItem><BreadcrumbLink href="#">Components</BreadcrumbLink></BreadcrumbItem>
<BreadcrumbSeparator />
<BreadcrumbItem><BreadcrumbPage>Breadcrumb</BreadcrumbPage></BreadcrumbItem>
</BreadcrumbList>
</Breadcrumb>
);
}API Reference
Breadcrumb
Wraps the breadcrumb navigation in a <nav> element with aria-label="breadcrumb".
BreadcrumbList
An ordered list (<ol>) container for breadcrumb items.
BreadcrumbItem
A list item (<li>) wrapper for each breadcrumb entry.
BreadcrumbLink
A styled anchor (<a>) for navigable breadcrumb items.
BreadcrumbPage
Renders a <span> (not a <div>) for the current/active page with aria-current="page".
BreadcrumbSeparator
Renders a separator between items. Defaults to "/" but accepts custom children.
BreadcrumbEllipsis
Displays a "..." indicator for collapsed navigation levels.