Breadcrumbs
Shows where the page sits in the hierarchy and lets people step back up. The last level is the current page and isn't a link.
Ritla scan of this preview: 41 of 41 checks3 breakpointsScanned
Preview
Mirrored is the same English content laid out right to left: it separates a mirroring bug from a translation one.
Installation
Add the component
npx ritla add breadcrumbAlso works with shadcn:
npx shadcn@latest add @ritla/breadcrumbDependencies it brings
@base-ui/react@phosphor-icons/reactOr copy by hand
Installing by hand copies the component's source into your project. The source comes with a Ritla UI license, so the CLI is the short way to the same files.
Usage
import { Breadcrumb, BreadcrumbItem } from "@/components/ui/breadcrumb";<Breadcrumb> <BreadcrumbItem href="/" home /> <BreadcrumbItem href="/accounts">Accounts</BreadcrumbItem> <BreadcrumbItem current>Q1 2026 statement</BreadcrumbItem></Breadcrumb>Examples
Your logo
Type = Logo: pass your logo instead of the home icon, and give it a name. Logos never mirror.
Long level
A long level is cut at 160px, and its full name shows in a tooltip on hover or focus, only when it's actually cut.
Collapsed levels
BreadcrumbCollapsed puts the middle levels behind "…" in a menu.
Router links
Pass Next's <Link> as render: it keeps its behavior and takes the level's look.
API reference
Breadcrumb
| Prop | Type | Default | Description |
|---|---|---|---|
children | ReactNode | None | The levels, from the top to the current page. |
BreadcrumbItem
| Prop | Type | Default | Description |
|---|---|---|---|
children | ReactNode | None | Figma's Label: the page's title as it is. |
href | string | None | Where the level goes. |
render | ReactElement | None | A router link (<Link>) with the level's look. |
current | boolean | false | Figma's Current: the page you're on, not a link, with aria-current="page". |
home | boolean | false | Type = Icon: the HouseLine icon named "Home". Pass your logo as children for Type = Logo. |
BreadcrumbCollapsed
| Prop | Type | Default | Description |
|---|---|---|---|
items | { label, href }[] | None | The collapsed middle levels, in order. |
Usage guidelines
Breadcrumbs show people where they are in a site's structure and take them back up a level. When to use them, how to name the levels, what to do with long trails, how they start from the right in Arabic, and the checks before handoff.
1. When to use them
Use breadcrumbs on pages two or more levels below a section's top: Settings, then Security, then Devices. They are secondary: the main navigation still does the heavy lifting, and on phones the app header's back button does the same job in less space.
| State | Use |
|---|---|
| Enabled | Short trails of up to four levels. |
| Truncated + tooltip | A long level name cut at 160 px; the full name shows on hover and focus. |
| Collapsed | Long trails: the middle levels move behind “…”, which opens a menu. |
Do
- Show breadcrumbs on pages two or more levels deep.
- Place them above the page title, at the inline start.
- Rely on the app header's back button on phones.
Don't
- Use breadcrumbs as the only navigation.
- Use them for steps in a flow; use Progress steps.
- Show a one-level trail on top-level pages.
2. Levels and names
Start from Home (the logo or the house icon), and name every level exactly like the title of the page it leads to. The last level is the current page: it isn't a link and is marked as current.
Do
- Use the page titles as level names.
- Start from the home logo or icon.
- Show the current page last, not as a link.
Don't
- Invent shorter names that don't match the pages.
- Link the current page to itself.
- Include categories that have no page of their own.
3. Long trails
Long level names are cut at 160 px with an ellipsis, and only then get a tooltip with the full name. When the trail passes about four levels, collapse the middle ones behind “…”: Home, the parent and the current page stay visible.
Do
- Keep Home, the parent and the current page visible.
- Collapse the middle levels behind “…” past about four levels.
- Let the truncated level show its full name on hover and focus.
Don't
- Wrap the trail onto two lines.
- Truncate the current page's name when there is room.
4. Arabic and RTL
The RTL variant starts the trail on the right, at Home, and the separators point left, toward the deeper levels. In code the separator sits in a mirrored list, so it flips by itself. Level names that mix Arabic and Latin, like a product name, stay readable because each level is isolated.
The trail runs from the right
Breadcrumbs above an Arabic account statement.
Before handoff
- Only on pages two or more levels deep.
- Level names match the page titles; the current page is last and not a link.
- Truncation and collapsing are shown for long trails.
- Arabic pages use the RTL variant, starting from the right.
Accessibility
Keyboard
Keys are written for left-to-right. In right-to-left the arrow keys swap: the one pointing toward the reading direction moves forward.
| Key | Action |
|---|---|
| Tab | Moves through the links; the current page isn't one. |
| Enter | Opens the level, or the menu of collapsed levels. |
| ArrowDownArrowUp | Inside the menu: through the collapsed levels. |
ARIA
- A
navnamed "Breadcrumb" in the page language, around an orderedol. - The last level has
aria-current="page"; the separators are hidden from screen readers. - The "…" button is named "Show hidden levels" and opens a menu of links.
Do
- Mark the current page with
aria-current="page". - Make the separators decorative and hidden from screen readers.
- Name the home icon or logo: “Home”.
- A 48 px touch target for every level.
Don't
- Read separators aloud as “slash” or “greater than”.
- Breadcrumbs without a landmark name.
Arabic and RTL notes
Mirrors
- The trail starts on the right, and the separators point left.
- The collapsed menu opens under "…" at the inline start.
Does not mirror
- The logo and the home icon.
- Numerals
- Numbers in titles stay as written; use
formatNumberfor ones you generate. - Arabic typography
body-14Medium for the levels, Semibold for the current page.- Mixed-direction text
- Never hard-code a right-pointing separator: it follows the direction on its own. Put an English name inside an Arabic title in
<bdi>.
Do
- The RTL variant, starting from Home on the right.
- Separators point left, toward the current page.
- Product and brand names stay in their own script.
Don't
- Hard-code right-pointing separators on Arabic pages.
- Reverse the level order by hand in the English variant.
Checks it passes
The Ritla checks this component satisfies by construction. Used as documented, it does not bring these defects onto your page.
- Untranslated attribute text (placeholder, alt, title, aria-label, button value)
- Clipped text: content wider than its box with overflow hidden and no ellipsis
- Fixed-pixel-width container whose Arabic text exceeds the space
- Arabic text falling back past the declared font family (measured, declared, or a webfont that failed to load)
- letter-spacing applied to Arabic text (breaks the connected script)
- flex row-reverse faking RTL instead of dir (tab order fights visual order)