How do I add Yoast breadcrumbs in the WordPress block editor?

The Citead team, updated

In short. Add the Yoast Breadcrumbs block from the WordPress editor’s block inserter, then move it to the intended position in the post or page.

Definition: Breadcrumbs show a page's position within a website's hierarchy. As of October 2026, Yoast SEO documents a Yoast Breadcrumbs block that adds this navigation to the content of an individual WordPress post or page.

Key facts

How is the block inserted?

Yoast's documented procedure starts in the WordPress dashboard under Posts or Pages. The editor opens the chosen content item, clicks the plus button in the upper left, searches for Yoast Breadcrumbs, and adds the block.

The WordPress Block Editor documentation identifies View as the control for checking the page with current changes applied. Save draft stores an unpublished page; Publish makes it public. After publication, View Post or View Page opens the public-facing result in a new tab.

How is its position in the content changed?

WordPress's Moving blocks guide explains that selecting a block exposes up and down arrow handles in its toolbar. These move the selected block through the post or page. Applied to the breadcrumb block, these controls determine its position relative to the other content blocks.

For a longer layout, Document Overview in the top toolbar opens List View. The block can be dragged up or down in that list and released when the insertion indicator reaches the intended location. The same documentation also permits moving blocks into or out of nested structures such as a Group block.

What is the shortcode alternative?

A shortcode is a bracketed instruction that WordPress processes within content. Yoast's block editor instructions provide an alternative: insert a Shortcode block and enter:

[wpseo_breadcrumb]

This also displays breadcrumbs on the individual content item.

How are breadcrumb labels edited?

Yoast's title-setting instructions place Breadcrumbs Title under Advanced in the Yoast SEO sidebar for a post or page. This field changes the breadcrumb label, including labels rendered by the block. The documented final action is Save, Update, or Republish. Yoast uses the example of shortening a long dog-training post title to “Dog training”.

FAQ

Does adding the block apply it to every page?

Yoast's implementation guide says the breadcrumbs are visible on the individual page. You add the block to each post or page that needs it.

Why might a local test show an incomplete path?

Yoast's developer documentation warns that local environments can omit intermediate breadcrumb nodes, including a post's category or a subpage's parent.

Sources

  1. Yoast, "How to implement Yoast SEO breadcrumbs", updated 24 February 2026
  2. WordPress.org, "Moving blocks", updated 2 September 2026
  3. Yoast, "The breadcrumbs title setting", updated 21 April 2026
  4. Yoast developer portal, "Blocks - Breadcrumbs", undated
  5. WordPress.org, "WordPress Block Editor", updated 14 September 2026
  6. Yoast developer portal, "Schema piece - Breadcrumb", undated

Check how a page reads to answer engines. Open the GEO score analyzer

Test a page and see what to fix first

The analysis usually takes less than 10 seconds and needs no account.

400,000+ pages scored in the public benchmark