Skip to content

Official government website An official website of the Federal Government of Nigeria

How you know
Federal Ministry of Communications, Innovation & Digital Economy Nigerian Design Standards

Breadcrumb

Shows where a page sits in the site, so people can go back up a level.

Added · New

Live example

Breadcrumb
Controls
Property Control What it does
Full trail. Collapsed: Home › … › Current. Mobile parent: one ‹ Parent link.
The page you are on. Shown last, not a link.

Overview

Put a breadcrumb under the header and above the page heading. It shows the trail of pages from Home to the one people are on, so they can see where they are and go back up a level.

Use a breadcrumb for

  • Sites more than two levels deep
  • Pages people often reach from search
  • Pages with one clear parent page

Don’t use a breadcrumb for

  • Sites one or two levels deep (a header link is enough)
  • Steps in a form or service (use a back link)
  • The home page

Examples

Three versions. Show the full trail when it fits, collapse it when it doesn’t, and use one parent link on mobile.

Default

The full trail, when it has 4 steps or fewer and fits on one line.

Mobile parent

One ‹ Parent link with a 48px tap area. Best on mobile, where people mostly go up one level.

Specifications

The properties of the breadcrumb. The same in HTML and React.

Breadcrumb properties
Property Type Possible values Description
items array
  • text + href
Required. One link per level, from Home to the parent page, in order.
current string
  • page title
Required. The page you are on. Shown last, as text, not a link.
collapse string
  • "auto" default
  • "never"
Optional. "auto" collapses to Home › … › Current when the trail has more than 4 steps or would wrap. Defaults to "auto".
mobile string
  • "trail"
  • "parent" default
Optional. "parent" shows one ‹ Parent link on small screens. Defaults to "parent".

In code, the breadcrumb is a <nav aria-label="Breadcrumb"> with an <ol>, one <li> per step. The current page is <li aria-current="page">, as text. Separators are drawn in CSS and never read out. The … is a <button aria-expanded="false"> that reveals the hidden levels in place.

Tokens

Breadcrumb tokens and contrast
Part Token Contrast on the page
Links Utility/caption (12px) · text/secondary. Hover: text/primary, underlined 6.6:1
Current page Label/small (12px, Medium) · text/primary 17.6:1
Separator icon/caret right, 12px (spacing/150) · text/secondary. Decoration only 6.6:1
… button Utility/caption · text/secondary · radius/050 6.6:1
Spacing spacing/100 between steps · spacing/050 above and below each step —
Focus Focus ring (border/focus) · radius/050, keyboard focus only —
Mobile parent Label/small · 48px tap area (spacing/600) 17.6:1

Use cases

Do

Collapse a long trail to Home › … › Current. Home stays first and the current page last.

Don’t

Don’t use a breadcrumb inside a step-by-step form. It shows where a page lives, not where someone has been. Use a back link to the previous step.

Layout

Where the breadcrumb goes and how it behaves.

Under the header, above the heading

After the skip link and the header, before the page heading and main content.

Full trail up to 4 steps
When it fits on one line.
Collapse longer trails

Home › … › Current, on any screen. … shows the hidden levels in place.

One parent link on mobile

‹ Parent with a 48px tap area, when people mostly go up one level.

Home first, current page last

Always, including when the trail is collapsed.

Copywriting

How to write the links in the trail.

Call it “Home”

Not the site name, and not a house icon on its own.

Use the page titles

Each link is the title of the page it goes to.

Shorten in the metadata

Shorten very long titles in the page metadata, not in the trail.

Same trail every time
However people arrived at the page.
One place per page

If a page sits in two places, pick the main one.

“…” means hidden levels

Never use it to cut a page title short.

Examples

Breadcrumb copywriting examples
Write Don’t write Why
Home Corporate Affairs Commission Short, and the same on every government site.
Births and deaths Births, deaths and… Never cut a title with “…”.
Request a copy of a birth certificate (text) Request a copy of a birth certificate (link) The current page is text. A link to it would go nowhere.
‹ Births and deaths ‹ Back Say where the link goes.
Services Click here for services Use the title of the page.

Accessibility

The breadcrumb is a named navigation landmark with an ordered list, so screen readers say how deep the page is.

Keyboard interaction for the breadcrumb
Key What it does
Tab Moves through the links and the … button, left to right. The current page and separators are skipped.
Shift + Tab Moves back.
Enter Follows a link. On …, shows the hidden levels and moves focus to the first one.
  • <nav aria-label="Breadcrumb"> names the landmark, so it isn’t confused with the main menu (WCAG 1.3.1, 2.4.8).
  • The current page has aria-current="page" and is not a link (WCAG 1.3.1, 4.1.2).
  • The … button has aria-expanded and an accessible name, “Show all breadcrumb levels” (WCAG 4.1.2).
  • The current page isn’t marked by colour alone: it’s last, Medium weight and not a link (WCAG 1.4.1).
  • Links 6.6:1 and current page 17.6:1 on white. Focus ring on keyboard focus only (WCAG 1.4.3, 2.4.7).

For developers

Copy the code for HTML, WordPress or React from the Code tab in Live example. The options are listed under Specifications.

For designers

Use Breadcrumb from 01 Library – Foundations. Pick Default, Collapsed or Mobile parent, and change the link labels and the current page. Don’t detach it.

References

Feedback

Report a problem with this page