Breadcrumbs

A linked list of pages leading to the current page, typically displayed at the top of the page.

Usage

Breadcrumbs are a helpful navigation aid when users are visiting your site. They are most often placed at the top or bottom of pages. This block is especially useful if you have a lot of pages, posts, or content linked within each other β€” it displays the hierarchy of your content and makes it easier to move around your site.

We use breadcrumbs on all our block documentation (see the trail at the top of this page) so you can easily maneuver around.

How the trail is built

The block builds its trail automatically from the current page context:

  • Pages β€” ancestor pages from the WordPress hierarchy, then optionally the current page title.
  • Posts β€” the primary category and its parent categories, then optionally the current post title.

When Show Home is enabled, a link to your site homepage is always the first item. When Show Current is enabled, the current page or post title appears as the final item (without a link).

The block outputs structured data using Schema.org BreadcrumbList markup for search engines.

Settings

Select the Breadcrumbs block to open its sidebar settings:

  • Show Home β€” display a hyperlink to your site's homepage as the first crumb.
  • Show Current β€” display the current page or post title as the final crumb.
  • Separator β€” character shown between links (the default is β€Ί).

Block width

Breadcrumbs supports Wide and Full alignment from the block toolbar. Use wide for a trail that follows your content column, or full width when the trail should span the entire page.

Screenshots

Front-end

  • Pill-style breadcrumbs above page copy on a Getting Started page.
  • Same pill trail on a deeper nested page in the Tour hierarchy.

Editor

  • Breadcrumbs settings β€” Show Home, Show Current, and Separator set to β€Ί.
  • Same controls with Separator set to > on a nested Tour page.

Settings

Settings

Show Home setting in the block editor sidebar
Show Home

Toggle this setting to display a hyperlink to your site's homepage as the first item in the breadcrumbs trail. This helps users quickly navigate back to your site's main page.

Show Current setting in the block editor sidebar
Show Current

Enable this to show the title of the current page or post as the final item in the breadcrumbs trail. This provides a clear indication of the user's current location without being a clickable link.

Separator setting in the block editor sidebar
Separator

Enter a character or string to be displayed between each link in the breadcrumbs trail. This allows you to customize the visual separation of the navigation items.