Browse Components

Components

Breadcrumb

Breadcrumbs help users to navigate and understand where they are on the current website or service.

DesignUsageAccessibilityUpdates

Purpose

Show page location

Breadcrumbs show where the current page sits in the site structure.

Link to parent pages

Each previous level is a link, so users can move back up quickly.

Support deep navigation

Use breadcrumbs when users may land inside a deep or nested section.

Anatomy

1

Page link

2

Separator

3

Overflow link

Configuration

Number of links

Control how many breadcrumb items are shown. When 5 or more items are present, the middle items automatically collapse into an overflow menu placed as the second link.

12345

Three items show a typical nested path from the root to the current page.

Overflow

When there are too many links, overflow can be applied by collapsing items into an ellipsis to prevent visual clutter.

With four or fewer items, every link stays visible. No ellipsis is needed.

Structure

Design tokens used

Each row is a colour, spacing, or size value the component uses, and the right-most column tells you where in the component you'll see it.

CategoryTokenValueWhere it's usedGapsgds-gap-xs8pxSpacing between items inside the component; spacing between items of the breadcrumbSizesgds-icon-size-smSize of breadcrumb separators and overflow icon

Usage

When to use

  • Use breadcrumb on deeper pages when users need to understand their place in the service hierarchy.
  • Use it when the trail helps users move up a level without losing context.

When not to use

  • Do not use breadcrumb on shallow journeys where the page title and main navigation already provide enough context.
  • Do not use vague or repetitive labels in the trail.

Best practices

Home Category Current page
Keep the current page as the last step

All earlier breadcrumb items should link back to previous levels, while the final item represents the current page.

Home Page 1 Page 2
Do not use generic labels

Generic names such as 'Page 1' and 'Page 2' do not help users understand the content or structure.

Use overflow on longer trails

When the hierarchy gets deeper, let the breadcrumb collapse middle levels into the built-in overflow menu.

Do not use breadcrumb for the wrong hierarchy

Breadcrumbs should reflect the actual site or service structure, not a temporary journey or task sequence.

Home Property for sale HDB for sale
Use specific, meaningful labels

Breadcrumb labels should match the page structure closely so users can predict where each level leads.

Home Services Payments Current page
Do not leave intermediate crumbs inactive

Every breadcrumb item before the current page should work as a link back to that level.

Accessibility considerations

Built-in accessibility

  • Breadcrumb items render links through the SGDS link component.
  • The last item is marked as the current location automatically.

Labels and content

  • Use link text that matches the destination page.
  • Keep the trail short enough for users to scan.

Focus and interaction

  • Users should be able to tab through breadcrumb links in page order and reach the overflow menu trigger when it appears.
  • Do not remove the native link destination from breadcrumb items.

Keyboard interaction

KeyInteractionTabMoves focus to the next breadcrumb link or to the overflow menu trigger when it is present.Shift+TabMoves focus to the previous breadcrumb link or back to the previous focusable element.EnterActivates the focused breadcrumb link, or opens the overflow menu when focus is on the ellipsis button.SpaceOpens the overflow menu when focus is on the ellipsis button.Tabor↓ DownMoves focus to the next item in the open overflow menu.Shift+Tabor↑ UpMoves focus to the previous item in the open overflow menu.EscCloses the overflow menu and returns focus to the ellipsis button.

Updates

DateVersionDescription13 May 2026v3.19.0Prevent last breadcrumb item from keyboard navigation in #648.04 May 2026v3.18.1Update separator with sgds icon in #637.23 Jan 2026v3.7.0Ensure breadcrumb text truncates with ellipsis instead of wrapping in #507.

Roadmap

Planned itemStatusTargetFuture enhancements for breadcrumbPlannedTBD

Feedback

Have suggestions or feedback?

Share them with us on Slack → #ask-sgds-v3

Bug Reports

Found a bug or issue?

Report it on GitHub Issues → sgds/components/breadcrumb

Singapore Government Design System

The Singapore Government Design System was developed to empower teams in creating fast, accessible and mobile-friendly digital services.

Past VersionsSGDS v1SGDS v2