Skip to content

Breadcrumbs

Get Ritla UI

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

Open in Figma

Preview

Mirrored is the same English content laid out right to left: it separates a mirroring bug from a translation one.

PreviewCode
EnglishMirroredArabic
LTR →

Installation

  1. Add the component

    npx ritla add breadcrumb

    Also works with shadcn: npx shadcn@latest add @ritla/breadcrumb

  2. Dependencies it brings

    @base-ui/react@phosphor-icons/react

  3. Or 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

breadcrumb.tsx
import { Breadcrumb, BreadcrumbItem } from "@/components/ui/breadcrumb";<Breadcrumb>  <BreadcrumbItem href="/" home />  <BreadcrumbItem href="/accounts">Accounts</BreadcrumbItem>  <BreadcrumbItem current>Q1 2026 statement</BreadcrumbItem></Breadcrumb>

Examples

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.

EnglishMirroredArabic
LTR →

Collapsed levels

BreadcrumbCollapsed puts the middle levels behind "…" in a menu.

EnglishMirroredArabic
LTR →

Router links

Pass Next's <Link> as render: it keeps its behavior and takes the level's look.

EnglishMirroredArabic
LTR →

API reference

Breadcrumb

PropTypeDefaultDescription
childrenReactNodeNoneThe levels, from the top to the current page.

BreadcrumbItem

PropTypeDefaultDescription
childrenReactNodeNoneFigma's Label: the page's title as it is.
hrefstringNoneWhere the level goes.
renderReactElementNoneA router link (<Link>) with the level's look.
currentbooleanfalseFigma's Current: the page you're on, not a link, with aria-current="page".
homebooleanfalseType = Icon: the HouseLine icon named "Home". Pass your logo as children for Type = Logo.

BreadcrumbCollapsed

PropTypeDefaultDescription
items{ label, href }[]NoneThe 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.

StateUse
EnabledShort trails of up to four levels.
Truncated + tooltipA long level name cut at 160 px; the full name shows on hover and focus.
CollapsedLong 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.

Do: RTL variantHome is on the right; the separators point left, toward the current page.
Don't: English trail on an Arabic pageHome is on the far left and the separators point the wrong way for Arabic.

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.

KeyAction
TabMoves through the links; the current page isn't one.
EnterOpens the level, or the menu of collapsed levels.
ArrowDownArrowUpInside the menu: through the collapsed levels.

ARIA

  • A nav named "Breadcrumb" in the page language, around an ordered ol.
  • 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 formatNumber for ones you generate.
Arabic typography
body-14 Medium 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.

  • R012Untranslated attribute text (placeholder, alt, title, aria-label, button value)
  • R042Clipped text: content wider than its box with overflow hidden and no ellipsis
  • R043Fixed-pixel-width container whose Arabic text exceeds the space
  • R050Arabic text falling back past the declared font family (measured, declared, or a webfont that failed to load)
  • R051letter-spacing applied to Arabic text (breaks the connected script)
  • R081flex row-reverse faking RTL instead of dir (tab order fights visual order)