How do I add Yoast breadcrumbs to a WordPress theme?

Definition: Yoast breadcrumbs provide navigation through a website's structure. As of 17 October 2026, Yoast documents theme integration through the yoast_breadcrumb() PHP function and the Enable breadcrumbs for your theme setting.

Key facts

• Yoast's implementation guide places the breadcrumb function in the theme where the trail should appear, then enables it under Yoast SEO > Settings > Advanced > Breadcrumbs.
• The WordPress Child Themes handbook explains that a child theme inherits its parent's design and functionality while keeping customizations separate from parent-theme updates.
• Yoast's theme-support documentation offers add_theme_support( 'yoast-seo-breadcrumbs' ); for theme developers after the breadcrumb display is integrated and checked.

Where does the theme integration function go?

The PHP function belongs at the location where the breadcrumb trail should render. Yoast's implementation guide supplies this code:

<?php
if ( function_exists('yoast_breadcrumb') ) {
  yoast_breadcrumb( '<p id="breadcrumbs">','</p>' );
}
?>

The condition checks that yoast_breadcrumb exists before calling it. The call wraps the output in a paragraph with the ID breadcrumbs.

Yoast names single.php and page.php, just above the page title, as common locations. It also suggests the end of header.php for some themes. The surrounding PHP context determines whether the opening and closing PHP tags are needed. Yoast advises against putting this display snippet in functions.php in most non-WooTheme themes.

A backup precedes theme-file editing in Yoast's instructions. The WordPress handbook explains how a child theme can override a parent template by providing a file with the same name. This provides a place for template changes that remain separate from updates to the parent theme.

How is breadcrumb output enabled?

Yoast's setup instructions describe the theme breadcrumb feature as disabled by default. After the template integration, the dashboard sequence is:

1. Open Yoast SEO > Settings.
2. Open Advanced > Breadcrumbs.
3. Set Enable breadcrumbs for your theme to On.
4. Adjust Breadcrumb appearance as required and select Save changes.

The enabled toggle displays a purple checkmark. The same Breadcrumbs settings include Separator between breadcrumbs, which controls the symbol separating trail items. These settings configure the breadcrumb display whose location is supplied by the theme integration.

When should a theme declare breadcrumb support?

For theme developers, Yoast's theme-support guide adds a separate integration step. After checking that breadcrumbs appear on every page and look correct, the theme can include this declaration in functions.php:

add_theme_support( 'yoast-seo-breadcrumbs' );

Yoast states that this declaration enables breadcrumbs immediately, so they start working when a theme user installs and activates Yoast SEO. The guide places the display check before the declaration: the template function still needs an appropriate location in the theme.

Related terms

• BreadcrumbList structured data
• Structured data
• How do I integrate a theme's schema output with Yoast SEO?

FAQ

Can I add breadcrumbs to one page without editing theme files?

Yes. Yoast's implementation guide documents the Yoast Breadcrumbs block for individual posts and pages. It also documents a Shortcode block containing:

[wpseo_breadcrumb]

How can I change the categories in the breadcrumb trail?

You can select a post's primary category, as described in the same Yoast guide. If you select a subcategory as primary, Yoast outputs both its parent category and the subcategory.

Sources

1. Yoast, "How to implement Yoast SEO breadcrumbs", updated 24 February 2026
2. WordPress Developer Resources, "Child Themes", updated 26 January 2024
3. Yoast, "Add theme support for Yoast SEO breadcrumbs", updated 13 May 2026

---

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