Skip to content
Design System
GitHub

Breadcrumb

v0.23.0

Where this page sits: links to the levels above, the current page last.

Breadcrumb default

Install
npx shadcn add @syncrobotic/breadcrumb

Also installs: lucide-react, @syncrobotic/cn

Overview

Where this page sits, as a row of links to the levels above it.

When to use

  • Pages two or more levels deep: a dataset inside a catalog, a robot inside a site.

Use something else

  • Moving between sections at one level: Tabs.
  • Top-level navigation: the app shell's sidebar.

More examples

States and real uses. Each example is also a Storybook story and a visual regression test.

Breadcrumb with icon

Breadcrumb collapsed

Breadcrumb with switcher

Breadcrumb truncated

Breadcrumb two levels

Maps

4 maps · updated 2 h ago

Breadcrumb page header

Usage rules

  • Each level is a link; the current page is last and is not.
  • In an app shell, pass it as breadcrumb: the top bar's title is the current page.

Changelog

  • 0.23.02026-11-20Every word it says can be translated without editing the source: labels.nav names the landmark (an aria-label still wins).
  • 0.17.42026-11-19The few-letters floor is on a middle crumb's name, not the item, so a short name (two characters) is no longer padded out with a gap before the next chevron.
  • 0.17.32026-11-19Middle crumbs shrink first; the first crumb keeps up to a third of the row.

How to upgrade