Breadcrumbs

Examples

View va-breadcrumbs in Storybook

Usage

• Breadcrumbs should be based on content hierarchy, not on the user’s click path or browser history.
  • For online applications and forms, the breadcrumb represents the forms’s placement within the site hierarchy, it does not track the steps or progress of the form flow. In other words, the breadcrumb will only show up to the form as the current page segment, and will maintain that display while the user goes through the flow. For navigation through the steps of the form flow, forward and backward CTAs can be provided as part of the main content as appropriate.
• If you use a breadcrumb for one page in a hierarchy, always use a breadcrumb for all pages within that hierarchy.
• Always use consistent styling and interactions for the breadcrumb throughout the site, so users do not experience unexpected changes as they navigate through related pages. This includes using a consistent character as a separator between segments.
• Each breadcrumb segment should match the H1 of the corresponding page. When writing H1s for a page, follow the content styleguide for writing page titles.
• On desktop, the breadcrumb path should always start with a link to the home page of the site and end with the current page as the last segment.
• On mobile, the breadcrumb will only display the parent of the current page. This breadcrumb should allow the user to move up one level at a time, all the way to the home page of the site. The mobile version of the breadcrumb does not show the current page.
• If a breadcrumb wraps to a second line, the line break must happen between segments(i.e. a single segment should not break into 2 lines) and maintain appropriate tappable space.

When to use

• Use a breadcrumb when content is more than 2 levels deep.
• Use a breadcrumb when it is important to the user to understand where they are in the site.
• Use a breadcrumb when the user may need to navigate up the hierarchy of their current page.

When not to use

• Do not use a breadcrumb on the top page of a site (i.e. the home page).
• Do not use a breadcrumb if the path or hierarchy of the page is irrelevant to the user or experience.
• Do not use a breadcrumb if the site/experience has a flat structure (i.e. only 2 levels of content or less)
• Do not use a breadcrumb if it would create a way for a user to exit or navigate away from a user flow that they are unable to return to, or would result in a loss of data.

Placement

• The breadcrumb should be placed below the header and above the main content.
• The placement of the breadcrumb must be consistent from page to page.

Behavior

• All the links in the breadcrumb, except the current page, should be interactive and link to their corresponding page.
• The current page segment of the breadcrumb should not be interactive or link.

SEO considerations

• Search engines utilize breadcrumbs to understand your site structure and gain additional context about your page to help in ranking.
• Breadcrumbs can also be displayed in search engine results pages (SERPs), which provides additional context to users about your page.
• Breadcrumbs are not the only element used by search engines, go to writing for SEO in the content styleguide for more SEO assistance.

Code usage

Attributes and Properties

Events