# Breadcrumb > Navigation breadcrumb trail for hierarchical page structure Source: https://shellui.dev/docs/v0.4/components/layout/breadcrumb The Breadcrumb component displays the user's current location within a site hierarchy, allowing quick navigation to parent pages. ## Installation ```bash shellui add breadcrumb ``` ## Basic Usage ```razor Home Documentation Components ``` ## With Links Non-last items render as clickable links when `Href` is provided: ```razor Home Products Electronics Headphones ``` ## Dynamic Breadcrumbs Generate breadcrumbs from route data: ```razor @foreach (var (segment, index) in breadcrumbs.Select((s, i) => (s, i))) { @segment.Label } @code { private List breadcrumbs = new() { new("Home", "/"), new("Settings", "/settings"), new("Profile", "/settings/profile") }; record BreadcrumbSegment(string Label, string Href); } ``` ## Custom Separator The default separator is `/`. You can customize it via CSS: ```razor Home Docs Breadcrumb ``` ## Composed from parts New in v0.4: for full control over links, separators and collapsed levels, set `UseList="true"` and build the trail from `BreadcrumbList`, `BreadcrumbLink`, `BreadcrumbPage`, `BreadcrumbSeparator` and `BreadcrumbEllipsis`. Inside a `BreadcrumbList`, items don't draw their own separator; you place each `BreadcrumbSeparator`. ```razor Home Components Breadcrumb ``` `BreadcrumbSeparator` shows a chevron by default. Give it content to use something else: ```razor Projects / ShellUI / Settings ``` ## API Reference ### Breadcrumb | Property | Type | Default | Description | |----------|------|---------|-------------| | `ChildContent` | `RenderFragment` | `null` | BreadcrumbItem children | | `Class` | `string?` | `null` | Additional CSS classes | ### BreadcrumbItem | Property | Type | Default | Description | |----------|------|---------|-------------| | `Href` | `string?` | `null` | Navigation link (renders as anchor when set) | | `IsLast` | `bool` | `false` | Marks the current/last item (no link styling) | | `ChildContent` | `RenderFragment` | `null` | Item label content | | `Class` | `string?` | `null` | Additional CSS classes | ### Parts | Component | Parameters | Purpose | |-----------|------------|---------| | `Breadcrumb` | `UseList` | Set `UseList="true"` when the children include a `BreadcrumbList` | | `BreadcrumbList` | `Class` | The ordered list | | `BreadcrumbLink` | `Href`, `Class` | A link to a parent page | | `BreadcrumbPage` | `Class` | The current page; sets `aria-current="page"` | | `BreadcrumbSeparator` | `Class` | The divider between items; content replaces the chevron | | `BreadcrumbEllipsis` | `Class` | Stands in for collapsed levels | ## Accessibility The Breadcrumb component includes: - `nav` element with `aria-label="breadcrumb"` - Ordered list (`ol`) for proper structure - `aria-current="page"` on the last item - Keyboard navigable links - Screen reader friendly separator handling