How to Fix: BreadcrumbList schema

BreadcrumbList schema is an important SEO check in the Internal Site Architecture category. This is a high-priority issue, and one of the highest returns on five minutes of work anywhere in this knowledge base.

What is This Check About?

This check verifies that your pages emit BreadcrumbList structured data — the machine-readable version of the “Home → Category → Product” trail. It does two jobs at once: it tells search engines exactly where a page sits in your site’s hierarchy, and it lets Google replace the raw URL in the search result with a clean, clickable breadcrumb path.

A visible breadcrumb on the page and the BreadcrumbList markup behind it are two different things. This check is about the markup. You want both, and you want them to agree.

Why Does This Matter for SEO?

• Google shows the breadcrumb trail in place of the URL in results, which reads as more trustworthy and can lift click-through.
• It communicates site structure and topical hierarchy, helping search engines understand how your pages relate.
• It reinforces internal linking and the flow of authority from category pages down to individual products or posts.
• On deep e-commerce catalogues, it is one of the clearest ways to express architecture that would otherwise be buried in the URL.

How to Check This Issue

1. Run an SEO audit with the SEO Roadmap tool to see whether breadcrumb markup is present.
2. Run a category or product URL through Google’s Rich Results Test and look for a valid Breadcrumbs result.
3. View source (F12) and search for "@type":"BreadcrumbList" in the JSON-LD.
4. Check the Breadcrumbs enhancement report in Search Console for errors or warnings.

How to Fix This in WordPress

Difficulty Level: EASY – This fix is straightforward and can typically be completed by anyone with basic WordPress knowledge.

Estimated Time: 5 min

Step 1: Enable breadcrumbs in your SEO plugin

Both Yoast SEO and Rank Math generate valid BreadcrumbList schema. In Yoast it lives under Settings → Breadcrumbs; in Rank Math under the Breadcrumbs module. Turn it on. For most sites the markup then ships automatically, no template edit required.

Step 2: Show the breadcrumb on the page (optional but recommended)

If your theme does not already display a breadcrumb, add the plugin’s breadcrumb block or template tag to your single and archive templates. The visible trail helps users and keeps the on-page path consistent with the markup.

Step 3: Verify the Fix

1. Clear your WordPress and CDN cache.
2. Run a product and a post URL through the Rich Results Test and confirm the Breadcrumbs result is valid.
3. Re-run the SEO Roadmap audit, then watch the Breadcrumbs report in Search Console over the following days.

The one thing that usually goes wrong

The failure I see most is not a missing breadcrumb — it is two of them. A theme outputs its own BreadcrumbList, the SEO plugin outputs another, and now Google sees duplicate, sometimes conflicting, breadcrumb schema on the same page. Pick one source and disable the other. If your theme has a built-in breadcrumb schema option and you also run Yoast or Rank Math, decide which one owns it and switch the loser off. Five minutes to enable, and the only way to get it wrong is to enable it twice.

Recommended Tools & Plugins

• Yoast SEO – Comprehensive SEO plugin with built-in checks
• Rank Math – Feature-rich SEO plugin with detailed analysis
• Google Search Console – Free tool to monitor your site’s search presence
• SEO Roadmap – Complete SEO audit and action plan tool

Common Mistakes to Avoid

• Emitting breadcrumb schema from both the theme and an SEO plugin at once.
• Showing a visible breadcrumb whose path disagrees with the markup.
• Enabling breadcrumbs only on posts and forgetting product and category templates.
• Never checking the Rich Results Test to confirm the markup actually validates.

Need More Help?

• Consulting a WordPress developer or SEO specialist
• Checking the WordPress support forums for similar issues
• Reviewing your theme and plugin documentation
• Running a complete site audit with SEO Roadmap for a prioritized action plan

This guide is part of the SEO Roadmap knowledge base – your complete resource for WordPress SEO optimization.