Rank Math Breadcrumbs: How to Turn Them On and Fix Them
By Toy Wen Da, Co-Founder · Updated · 7 min read · scored 93/100
Rank Math breadcrumbs are the small trail of links (Home > Category > Page) that Rank Math can generate for every post and page on your WordPress site, as well as archives. If they're missing, the fix is usually one toggle: go to Rank Math's General Settings, open the Breadcrumbs tab, and switch the feature on.
What Rank Math breadcrumbs actually do
A breadcrumb trail shows visitors where a page sits in your site's structure. On a recipe blog, that might read Home > Recipes > Desserts > Lemon Bars, and on an e-commerce store it's Home > Shoes > Running > Men's Trail Shoes.
Rank Math builds the trail automatically from your category, tag and page hierarchy, so you never write it by hand. The plugin also wraps the output in schema.org markup, specifically the BreadcrumbList type, which tells search engines the exact structure of the trail and not just the visible text.
Why breadcrumbs matter for SEO
Google has documented breadcrumb structured data as one of the signals it can use to replace a plain URL with a readable path in search results, for example showing "searchblueprint.io › Blog › SEO" instead of the raw web address (Google Search Central). It doesn't guarantee a ranking boost, but it makes your listing easier to scan and tells users where a result will take them before they click.
Visitors also use breadcrumbs to move up a level without hitting the back button, which can reduce bounce rate on deep pages such as category archives, blog posts or product pages buried several clicks from the homepage.
How to turn on breadcrumbs in Rank Math
Step 1: open the breadcrumbs settings
In your WordPress dashboard, go to Rank Math > General Settings and click the Breadcrumbs tab. Toggle Breadcrumbs to ON and save your changes.
Step 2: check whether your theme already supports them
Several popular themes detect Rank Math and insert the trail automatically once the setting is on, among them Astra and GeneratePress, along with Kadence and OceanWP. If yours is one of these, you're usually done after step 1.
Step 3: add the breadcrumb code if your theme doesn't auto-detect
If nothing appears on the front end, your theme needs the breadcrumb function added manually. Rank Math's settings page shows a PHP snippet, typically something close to:
<?php if ( function_exists( 'rank_math_the_breadcrumbs' ) ) { rank_math_the_breadcrumbs(); } ?>
Paste this into your theme's single.php, page.php or archive.php file, right above the page title. Use a child theme or the theme's custom hook area so a future theme update doesn't wipe it out. If you're not comfortable editing theme files directly, a lightweight code-snippet plugin or your theme's hook system is a safer place for it.
Step 4: confirm the output on the front end
Visit a post or category page and look for the trail near the top of the content. Then check that the schema registered correctly: Google's Rich Results Test will show whether the BreadcrumbList markup is valid.
Breadcrumb settings worth customizing
Once the trail is live, Rank Math gives you several fields to shape how it reads, all in the same Breadcrumbs tab.
| Setting | What It Controls | Typical Use Case |
|---|---|---|
| Separator | The character between items (e.g., >, /, ») |
Match your site's visual style |
| Home Label | The text for the first item in the trail | Change "Home" to your brand name |
| Prefix | Text shown before the whole trail | Add a label like "You are here:" |
| Archive Format | How category and tag archives appear in the trail | Keep long category names readable |
| Show Breadcrumb for the Homepage | Whether the homepage itself shows a trail | Usually left off since it's redundant |
None of these settings affect rankings on their own, but they do affect readability, and a trail that's hard to parse defeats its purpose.
Why breadcrumbs might not be showing
If you've flipped the toggle and nothing changes on the front end, the cause is almost always one of a handful of things.
| Symptom | Likely Cause | Fix |
|---|---|---|
| Nothing appears anywhere on the site | Theme doesn't call the breadcrumb function | Add the PHP snippet from the settings page |
| Breadcrumbs show on posts but not products | Page builder or custom template overrides the layout | Add the snippet inside the builder's template, not just the theme file |
| Breadcrumbs appeared, then vanished after an update | Theme update overwrote the custom template file | Re-add the snippet in a child theme |
| Trail shows but schema doesn't validate | Caching plugin served an old, cached page | Clear site cache and retest |
| Trail text looks broken or duplicated | Another SEO plugin is also outputting breadcrumbs | Disable breadcrumbs in the other plugin |
The last row comes up often for people who used another SEO plugin before. Our Rank Math vs Yoast comparison sets the two side by side and covers how each handles breadcrumbs and schema.
When WordPress's own tools are enough, and when they're not
For a single site with one theme and a handful of templates, Rank Math's built-in breadcrumb settings are enough: you turn the feature on, confirm it renders and move on, with no outside tool needed to check one toggle.
The gap shows up at scale. If you manage several client sites, or one site with dozens of templates (custom post types, a shop, a knowledge base, a blog), checking breadcrumb and schema output page by page in WordPress becomes slow. WordPress also won't alert you if breadcrumbs quietly break after a theme update three months from now.
At that point it helps to have something watching the site continuously instead of a manual check done once. If you're new to the plugin itself, this walkthrough of what Rank Math does and how it's structured is a useful starting point before you dig into settings like breadcrumbs.
A one-off check vs. a recurring one
- For one URL at one point in time, Rank Math's settings page and a quick look at the live page are sufficient.
- For a whole site over time, you want monitoring that flags when breadcrumb schema disappears, a template breaks or a plugin conflict reintroduces duplicate markup, so nobody has to remember to go and look.
Common mistakes to avoid
- Enabling breadcrumbs in two SEO plugins at once produces duplicate markup and a visibly broken trail.
- Editing the parent theme file instead of a child theme means the next theme update erases the snippet.
- Assuming the toggle alone finishes the job is risky because many themes need the manual snippet, and only the live page tells you for sure.
- A visible trail without valid BreadcrumbList markup still misses the search-result benefit, so check the schema as well.
- Forgetting to retest after a theme or plugin update is the single most common reason breadcrumbs that worked last month stop working this month.
FAQs
Does Rank Math add breadcrumbs automatically?
No. Rank Math generates the breadcrumb trail and the underlying code, but your theme has to call that code to display it. Many popular themes do this automatically, and others need a short snippet added manually.
Why do my Rank Math breadcrumbs show on pages but not posts?
This usually means your theme or page builder only calls the breadcrumb function in one template file. Check whether the snippet is present in both page.php and single.php, or in the builder's equivalent.
Do Rank Math breadcrumbs help SEO rankings?
They don't directly boost rankings. They do add BreadcrumbList schema that can help Google display a readable path in search results, and they improve on-site movement between pages, which can reduce bounce rate.
Can I use breadcrumbs from Rank Math and my theme at the same time?
No, because that creates duplicate trails or conflicting schema. Pick one source, usually Rank Math since it keeps the markup consistent with your SEO settings, and turn off the other.
How do I check if my breadcrumb schema is valid?
Load a page with breadcrumbs through Google's Rich Results Test, or inspect the page source for a BreadcrumbList JSON-LD block. If it's missing or malformed, the fixes in the troubleshooting table above cover the usual causes.
What to do next
Turn the Breadcrumbs toggle on inside Rank Math's General Settings, check one post and one category page on the front end, and add the template snippet if nothing shows up. Once breadcrumbs are live, it's worth watching whether rankings for those pages move. You can track that with SearchBlueprint's rank tracking or run a quick position check with the free keyword rank checker. If you'd like to see what a full audit of your site's SEO setup looks like before committing to anything, from breadcrumbs and schema to everything else, talk to the team and we'll walk you through a sample SEO report.
Resources / References
About the author
SearchBlueprint researched, wrote and scored this article with the content pipeline our customers run on their own sites. The score in the byline is what our content engine gave this page before it published. Nothing here is reviewed by hand, which is the point: it is the product's output, published where anyone can check it.