Justin Tadlock

<p>Breadcrumb Trail is one of the most advanced and robust breadcrumb menu systems available for WordPress.  It started out as a small script for basic blogs but has grown into a system that can handle nearly any site’s setup to show the most accurate breadcrumbs for each page.</p>
<h3>Before using</h3>
<p>Please note that Breadcrumb Trail requires that you understand and know how to edit your theme’s PHP code, at least to the extent of copying and pasting one line of code.  If you’re not comfortable doing this, it’s best to ask that your theme author integrate the code necessary to support this plugin.</p>
<h3>How it works</h3>
<p>This plugin automatically detects your permalink setup and displays breadcrumbs based off that structure.  Nearly all sites have some sort of hierarchy.  Breadcrumb Trail recognizes that and builds a set of unique breadcrumbs for each page on your site.</p>
<p>This means that it can also detect custom post types and taxonomies right out of the box.  Whatever you throw at it, it’s got a solution.</p>
<h3>Features</h3>
<ul>
<li>Auto-detects the permalink structure of your site for the most accurate breadcrumbs.</li>
<li>Hooks for plugin/theme developers to overwrite output.</li>
<li>Coded with object-oriented programming (OOP) methods to allow developers to extend it for those highly-custom setups.</li>
<li>Properly handles nearly any custom post type or taxonomy.</li>
</ul>
<h3>Professional support</h3>
<p>If you need professional plugin support from me, the plugin author, you can join the club at <a href="https://themehybrid.com/club" rel="nofollow ugc">Theme Hybrid</a>, which is a professional WordPress help/support site where I handle support for all my plugins and themes for a community of 75,000+ users (and growing).</p>
<h3>Plugin Development</h3>
<p>If you’re a theme author, plugin author, or just a code hobbyist, you can follow the development of this plugin on it’s <a href="https://github.com/justintadlock/breadcrumb-trail" rel="nofollow ugc">GitHub repository</a>.</p>
<h3>Donations</h3>
<p>Yes, I do accept donations.  If you want to donate, you can do so from my <a href="https://themehybrid.com/donate" rel="nofollow ugc">donations page</a> or grab me something from my <a href="http://a.co/flUb0ns" rel="nofollow ugc">Amazon Wish List</a>.</p>
<p>I appreciate all donations, no matter the size.  Further development of this plugin is not contingent on donations, but they are always a nice incentive.</p>


Breadcrumb Trail

This plugin is one of my go-to plugins when it comes to menu-based breadcrumbs. Keep it up!

Great solid plugin

A powerful script for adding breadcrumbs to your site that supports Schema.org HTML5-valid microdata.

<p>X3P0: Breadcrumbs is the most robust breadcrumb navigation system for WordPress. Built on 15+ years of development, it automatically detects your permalink structure and displays accurate breadcrumbs for every page on your site.</p>
<p>Perfect for improving site navigation and SEO, this breadcrumbs plugin works seamlessly with both block themes and classic themes. Simply insert the Breadcrumbs block via the WordPress Site Editor or add it to your theme templates.</p>
<h4>Key Features</h4>
<p><strong>Automatic Site Structure Detection</strong></p>
<p>The plugin automatically detects your permalink setup and builds breadcrumbs based on your site’s hierarchy. No configuration needed–it just works out of the box. But you can also customize if you need to change it.</p>
<p><strong>Custom Post Type Support</strong></p>
<p>Automatically recognizes custom post types and custom taxonomies created by other plugins or your theme. Whether you’re running an ecommerce solution, a portfolio site, or any custom setup, breadcrumbs will display correctly.</p>
<p><strong>Block Theme and Classic Theme Compatible</strong></p>
<p>Insert breadcrumbs using the WordPress block editor in any template, template part, or pattern. For classic themes, easily add breadcrumbs using a simple PHP function call.</p>
<p><strong>Developer Customization</strong></p>
<p>Built on a robust object-oriented PHP foundation with extensive hooks and filters. Developers can customize every aspect of breadcrumb generation and display.</p>
<p><strong>Schema.org Structured Data Support</strong></p>
<p>Choose from plain HTML, Schema.org microdata, or RDFa formats for optimal SEO and search engine visibility.</p>
<p><strong>Flexible Display Options</strong></p>
<p>Control which breadcrumb items display, customize separators, hide breadcrumbs on specific pages, and style breadcrumbs to match your theme.</p>
<h4>How to Add Breadcrumbs to Your Site</h4>
<p><strong>For Block Themes:</strong></p>
<ol>
<li>Go to <strong>Appearance <span aria-hidden="true" class="wp-exclude-emoji">→</span> Editor</strong></li>
<li>Open your Header template part (or any template where you want breadcrumbs)</li>
<li>Click the block inserter (+) and search for “Breadcrumbs”</li>
<li>Insert the block and customize settings in the block sidebar</li>
<li>Save your template</li>
</ol>
<p>The breadcrumbs will automatically display site-wide based on your permalink structure.</p>
<p><strong>For Classic Themes:</strong></p>
<p>Add this code to your <code>header.php</code> or any template file where you want breadcrumbs to appear:</p>
<pre><code><?= do_blocks('') ?>
</code></pre>
<h4>SEO Benefits</h4>
<p>Breadcrumbs improve your site’s search engine optimization by:</p>
<ul>
<li>Providing clear site structure signals to search engines</li>
<li>Reducing bounce rates by offering easy navigation</li>
<li>Supporting Schema.org structured data markup</li>
<li>Creating internal linking structure automatically</li>
<li>Improving user experience and site usability</li>
</ul>
<p>Search engines like Google display breadcrumbs in search results when properly formatted, giving your site more visibility and higher click-through rates.</p>
<h4>Supported Content Types</h4>
<p>The breadcrumbs plugin automatically handles:</p>
<ul>
<li>Pages and subpages (hierarchical structure)</li>
<li>Blog posts with category breadcrumbs</li>
<li>Custom post types (products, portfolios, etc.)</li>
<li>Custom taxonomies (tags, genres, locations, etc.)</li>
<li>Archive pages (date, author, taxonomy archives)</li>
<li>Search results pages</li>
<li>404 error pages</li>
<li>Attachment pages</li>
</ul>
<h4>Customization Options</h4>
<p><strong>Block Settings:</strong></p>
<ul>
<li>Show/hide on the homepage</li>
<li>Show/hide first crumb (home link)</li>
<li>Show/hide last crumb (current page)</li>
<li>Link the last crumb (current page)</li>
<li>Choose separator style (e.g., slash, arrow, greater-than, bullet, chevron)</li>
<li>Customize labels and text</li>
<li>Determine whether to automatically detect permalink structure</li>
<li>Choose taxonomies to match post types</li>
</ul>
<p><strong>Developer Options:</strong></p>
<ul>
<li>Custom query classes for unique breadcrumb logic</li>
<li>Custom assembler classes for conditional breadcrumb display</li>
<li>Custom crumb classes for specialized breadcrumb items</li>
<li>Filter hooks for modifying which breadcrumbs are shown</li>
</ul>
<h4>How It Works</h4>
<p>This breadcrumbs plugin analyzes the current WordPress query and generates breadcrumbs based on:</p>
<ol>
<li><strong>Your permalink structure</strong> – Date-based, post name, category-based, or custom</li>
<li><strong>Content hierarchy</strong> – Parent pages, category relationships, custom taxonomies</li>
<li><strong>Post type configuration</strong> – Custom post type archives and relationships</li>
<li><strong>Taxonomy settings</strong> – Primary categories and taxonomy hierarchies</li>
</ol>
<p>The plugin automatically detects these settings and builds the most accurate breadcrumb trail for each page, so you don’t need to configure complex rules.</p>
<h4>Developer Documentation</h4>
<p>For developers who want to customize breadcrumbs programmatically, the plugin provides extensive PHP classes and hooks. See the <a href="https://github.com/x3p0-dev/x3p0-breadcrumbs" rel="nofollow ugc">GitHub repository</a> for full developer documentation.</p>
<h4>Why Choose X3P0: Breadcrumbs?</h4>
<p>Unlike simpler breadcrumb plugins, X3P0: Breadcrumbs handles complex site structures automatically:</p>
<ul>
<li><strong>Hierarchical pages</strong> – Automatically shows parent <span aria-hidden="true" class="wp-exclude-emoji">→</span> child relationships</li>
<li><strong>Category-based permalinks</strong> – Shows category structure in URLs</li>
<li><strong>Date-based archives</strong> – Displays year/month/day breadcrumb trails</li>
<li><strong>Custom post type archives</strong> – Links back to custom post type archive pages</li>
<li><strong>Taxonomy hierarchies</strong> – Displays parent/child category relationships</li>
<li><strong>Multisite networks</strong> – Can include network home in breadcrumb trail</li>
</ul>
<p>The plugin has been refined since 2009, making it one of the most mature and reliable breadcrumb solutions for WordPress.</p>

Breadcrumbs Block – Navigation Trail


Simple, well-coded, and incredibly performant, X3P0: Breadcrumbs rapidly became one of my favorite plugins due to its lightweight approach and design freedom.



Definitely should be part of the WordPress core.


Should be part of the WordPress core

Add breadcrumb navigation to any site. Works with block and classic themes. Auto-detects site structure and custom post types. Improves SEO.

Breadcrumb Trail vs Breadcrumbs Block – Navigation Trail