How do I add Rank Math breadcrumbs to a theme?

The Citead team, updated

In short. Enable breadcrumbs in Rank Math, then add its display function to a PHP template or its shortcode to a block template.

Definition: Breadcrumbs are navigation links that show a visitor's location within a website. As of 17 October 2026, Rank Math documents enabling its breadcrumb function in General Settings and adding a template function or shortcode to display the trail.

Key facts

Where are breadcrumbs enabled?

The activation instructions place the settings at Rank Math SEO → General Settings → Breadcrumbs. Advanced Mode makes this section available when it is missing. Enabling Enable Breadcrumbs Function reveals the remaining options. The guide also instructs enabling the Schema module so Rank Math can add breadcrumb structured data, the machine-readable description of the trail.

The general settings documentation describes Separator Character, which accepts a custom separator, and Show Homepage Link, which reveals the homepage label and destination fields. Hide Post Title removes the post title from the trail. These settings control the trail's contents and presentation.

How is the trail added to a PHP template?

Rank Math's theme integration instructions provide this code for the desired display location:

<?php if (function_exists('rank_math_the_breadcrumbs')) rank_math_the_breadcrumbs(); ?>

The appropriate file depends on the theme; the guide names single.php and header.php as common locations. It also advises removing existing breadcrumbs supplied by another plugin or the theme to avoid conflicts.

A child theme keeps these customizations separate from the parent. The WordPress handbook explains that a child template with the same filename overrides its parent counterpart. Custom PHP functions belong in the child's own functions.php; WordPress loads both themes' functions files.

How does a block theme display breadcrumbs?

The block theme instructions use Appearance → Editor → Templates. The selected template receives a Shortcode block containing:

[rank_math_breadcrumb]

Saving the template displays the trail on pages using that template. The same shortcode also works in individual posts or pages.

What changes with native theme support?

The native support instructions tell theme authors to register support in functions.php, or through the after_setup_theme hook:

add_theme_support( 'rank-math-breadcrumbs' );

The theme also includes the display function shown above. With this integration, the breadcrumb enable/disable control disappears, while the other editing options remain available.

The documented inspection path is Rank Math SEO → Status and Tools → System Info → Active Theme. The Theme features list contains rank-math-breadcrumbs when support is registered.

FAQ

Why does enabling the setting leave the trail invisible?

Rank Math's general settings guide also requires display code. Check that your template calls the function or includes the shortcode.

Why is the breadcrumb switch missing?

The integration guide explains that native theme support removes the switch. You can check for rank-math-breadcrumbs in the Active Theme information.

Sources

  1. Rank Math, "Rank Math General Settings", undated
  2. Rank Math, "How to Enable Breadcrumbs on Your Website With Rank Math SEO", undated
  3. WordPress, "Child Themes", updated 26 January 2024

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