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

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.

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.

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.