Title: X3P0: Breadcrumbs Author: Justin Tadlock Published: 25. oktober 2023 Last modified: 23. februar 2026 --- Søk gjennom innstikk ![](https://ps.w.org/x3p0-breadcrumbs/assets/banner-772x250.png?rev=3392246) ![](https://ps.w.org/x3p0-breadcrumbs/assets/icon-256x256.png?rev=3376779) # X3P0: Breadcrumbs Av [Justin Tadlock](https://profiles.wordpress.org/greenshady/) [Last ned](https://downloads.wordpress.org/plugin/x3p0-breadcrumbs.4.1.0.zip) * [Detaljar](https://nn.wordpress.org/plugins/x3p0-breadcrumbs/#description) * [Omtalar](https://nn.wordpress.org/plugins/x3p0-breadcrumbs/#reviews) * [Utvikling](https://nn.wordpress.org/plugins/x3p0-breadcrumbs/#developers) [Hjelp](https://wordpress.org/support/plugin/x3p0-breadcrumbs/) ## Skildring X3P0: Breadcrumbs is the most robust breadcrumb navigation system for WordPress. Built on 17+ years of development, it automatically detects your permalink structure and displays accurate breadcrumbs for every page on your site. 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. #### Key Features **Automatic Site Structure Detection** 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. **Custom Post Type Support** 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. **Block Theme and Classic Theme Compatible** 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. **Developer Customization** Built on a robust object-oriented PHP foundation with extensive hooks and filters. Developers can customize every aspect of breadcrumb generation and display. **Schema.org Structured Data Support** Choose from plain HTML, Schema.org microdata, or RDFa formats for optimal SEO and search engine visibility. **Flexible Display Options** Control which breadcrumb items display, customize separators, hide breadcrumbs on specific pages, and style breadcrumbs to match your theme. #### How to Add Breadcrumbs to Your Site **For Block Themes:** 1. Go to **Appearance Editor** 2. Open your Header template part (or any template where you want breadcrumbs) 3. Click the block inserter (+) and search for «Breadcrumbs» 4. Insert the block and customize settings in the block sidebar 5. Save your template The breadcrumbs will automatically display site-wide based on your permalink structure. **For Classic Themes:** Add this code to your `header.php` or any template file where you want breadcrumbs to appear: ``` ') ?> ``` #### SEO Benefits Breadcrumbs improve your site’s search engine optimization by: * Providing clear site structure signals to search engines * Reducing bounce rates by offering easy navigation * Supporting Schema.org structured data markup * Creating internal linking structure automatically * Improving user experience and site usability Search engines like Google display breadcrumbs in search results when properly formatted, giving your site more visibility and higher click-through rates. #### Supported Content Types The breadcrumbs plugin automatically handles: * Pages and subpages (hierarchical structure) * Blog posts with category breadcrumbs * Custom post types (products, portfolios, etc.) * Custom taxonomies (tags, genres, locations, etc.) * Archive pages (date, author, taxonomy archives) * Search results pages * 404 error pages * Attachment pages #### Customization Options **Block Settings:** * Show/hide on the homepage * Show/hide first crumb (home link) * Show/hide last crumb (current page) * Link the last crumb (current page) * Choose separator style (e.g., slash, arrow, greater-than, bullet, chevron) * Customize labels and text * Determine whether to automatically detect permalink structure * Choose taxonomies to match post types **Developer Options:** * Custom query classes for unique breadcrumb logic * Custom assembler classes for conditional breadcrumb display * Custom crumb classes for specialized breadcrumb items * Filter hooks for modifying which breadcrumbs are shown #### How It Works This breadcrumbs plugin analyzes the current WordPress query and generates breadcrumbs based on: 1. **Your permalink structure** – Date-based, post name, category-based, or custom 2. **Content hierarchy** – Parent pages, category relationships, custom taxonomies 3. **Post type configuration** – Custom post type archives and relationships 4. **Taxonomy settings** – Primary categories and taxonomy hierarchies 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. #### Developer Documentation For developers who want to customize breadcrumbs programmatically, the plugin provides extensive PHP classes and hooks. See the [GitHub repository](https://github.com/x3p0-dev/x3p0-breadcrumbs) for full developer documentation. #### Why Choose X3P0: Breadcrumbs? Unlike simpler breadcrumb plugins, X3P0: Breadcrumbs handles complex site structures automatically: * **Hierarchical pages** – Automatically shows parent child relationships * **Category-based permalinks** – Shows category structure in URLs * **Date-based archives** – Displays year/month/day breadcrumb trails * **Custom post type archives** – Links back to custom post type archive pages * **Taxonomy hierarchies** – Displays parent/child category relationships * **Multisite networks** – Can include network home in breadcrumb trail The plugin has been refined since 2009, making it one of the most mature and reliable breadcrumb solutions for WordPress. ## Skjermbilete * [[ * Breadcrumbs block in the Site Editor. * [[ * Home icon picker. * [[ * Separator icon picker. ## Blokker Denne utvidinga gjev 1 blokk. * Breadcrumbs Add a breadcrumb trail back to the site homepage. Breadcrumb items appear as placeholders in the editor and will populate with the correct data on the site front end. ## Vanlege spm. ### How do I add breadcrumbs to my WordPress site? For block themes, open the Site Editor (**Appearance Editor**), edit your Header template part, and insert the Breadcrumbs block. For classic themes, add `') ?>` to your template files. ### Do breadcrumbs help with SEO? Yes. Breadcrumbs improve SEO by providing clear site structure to search engines, reducing bounce rates, and creating internal links. They also appear in Google search results when properly formatted, improving click-through rates. ### Does this work with custom post types? Yes. The plugin automatically detects all custom post types and taxonomies on your site and generates appropriate breadcrumbs for them without any configuration. ### Can I customize the breadcrumb separator? Yes. In the block settings panel, you can choose from several separator styles, including slash (/), arrow (), bullet (•), chevron (›), and more. ### How do I hide breadcrumbs on the homepage? In the block settings panel, toggle off **Show on homepage**. ### Can I show category breadcrumbs for blog posts? Yes. In the block settings panel, select a taxonomy under the **Post Taxonomies** panel. You can choose the taxonomy for any post types registered on your site. ### How do I add breadcrumbs to specific pages only? Insert the Breadcrumbs block directly into individual page templates or use conditional logic in your theme templates to control where breadcrumbs appear. ### Does the plugin support Schema.org markup? Yes. The plugin includes three markup options: plain HTML, Schema.org microdata, and RDFa format. Developers can specify which format to use when implementing breadcrumbs via PHP. ### How do I customize breadcrumb labels? In the block settings panel, select the label you want to customize under the ** Labels** panel. This provides a subset of common labels that you may want to modify. ### Why don’t my breadcrumbs show parent pages? Make sure your pages are actually set as parent/child in the page editor. The plugin reads the page hierarchy from WordPress and displays it automatically. ### Does this work with page builders? Yes. You can insert the Breadcrumbs block into any page builder that supports WordPress blocks, including patterns and reusable blocks. ### How do I add custom breadcrumbs for specific pages? Developers can use the `x3p0/breadcrumbs/resolve/query-type` filter hook to implement custom breadcrumb logic for specific conditions. ### Can I hide the current page from breadcrumbs? Yes. In the block settings, toggle off **Show last breadcrumb**. ### Is the plugin translation-ready? Yes. The plugin is fully internationalized and has been translated into multiple languages. All labels and text can be translated using standard WordPress translation tools. ### Can I style the breadcrumbs with CSS? Yes. The breadcrumbs output standard HTML with CSS classes you can target. You can customize it with the common design tools available in the Site Editor or manually via `theme.json`. ### Does it work with date-based permalink structures? Yes. If your site uses date-based permalinks (e.g., `/2025/10/post-name/`), the plugin automatically generates breadcrumbs showing Home Year Month Day Post. ### How do I display taxonomy breadcrumbs for custom post types? In the block settings panel, select a taxonomy under the **Post Taxonomies** panel. Choose your custom post type and its associated taxonomy. ### How do I troubleshoot breadcrumbs not appearing? Check that: 1. The block is inserted in your template 2. **Show on homepage** is enabled if testing on homepage 3. Your theme doesn’t have CSS hiding breadcrumbs 4. There are no PHP errors in your error log ### How to use breadcrumbs for better navigation? **Step 1: Choose Your Template** Decide where breadcrumbs should appear. Most sites display them in the header, just below the site title and navigation menu, or at the top of the content area. **Step 2: Insert the Block** Navigate to **Appearance Editor**, open your chosen template part, and insert the Breadcrumbs block using the block inserter. **Step 3: Configure Settings** Customize the block appearance using the settings panel. Choose your separator style, decide whether to show breadcrumbs on the homepage, and adjust visibility of the first and last items. **Step 4: Test Different Pages** Visit different page types (single posts, category archives, pages, search results) to see how breadcrumbs adapt to each context. ## Omtalar ![](https://secure.gravatar.com/avatar/8f9236b038935f72545147593e6497ee3b5257a4bb425792df7ceb051dfd83e0? s=60&d=retro&r=g) ### 󠀁[Excellent](https://wordpress.org/support/topic/excellent-13992/)󠁿 [antiriad](https://profiles.wordpress.org/antiriad/) 14. juli 2025 I wanted a nice Blocks compatible breadcrumb plugin and this one is perfect. Thank you for making it available. ![](https://secure.gravatar.com/avatar/2d09f8bacd00494073c806854b14b832acaae075d572a1fa7a7bd52d407604ea? s=60&d=retro&r=g) ### 󠀁[Nice for developers too!](https://wordpress.org/support/topic/nice-for-developers-too/)󠁿 [melcarthus](https://profiles.wordpress.org/melcarthus/) 28. april 2025 Really nice README that shows how to use hooks and filters to make the plugin do what you want. A site i’m working on did not need taxonomies so I simply added a filter that removed it from the breadcrumbs really nice!Would maybe be helpful for non codes to add options to hade parts of the permalink structure if for example like my website, the default category taxonomy is not used. ![](https://secure.gravatar.com/avatar/0a065325cb5e6f5804f6230b5f3816f2dc44b1cc71779c836bd004a6ac466b67? s=60&d=retro&r=g) ### 󠀁[Should be part of the WordPress core](https://wordpress.org/support/topic/should-be-part-of-the-wordpress-core-3/)󠁿 [Alex de Borba](https://profiles.wordpress.org/alexdeborba/) 8. november 2024 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. ![](https://secure.gravatar.com/avatar/1dc364b60063b77814324a4f1e73b50d103586b9d255f4a7f6345c9545c8af8e? s=60&d=retro&r=g) ### 󠀁[This block should be included in WordPress](https://wordpress.org/support/topic/this-block-should-be-included-in-wordpress/)󠁿 [Matija](https://profiles.wordpress.org/matija80/) 6. november 2024 I really love this plugin – it’s simple, clean, and easy to use. It deserves to be part of the default WordPress installation. [ Les alle 4 omtalar ](https://wordpress.org/support/plugin/x3p0-breadcrumbs/reviews/) ## Bidragsytarar og utviklarar “X3P0: Breadcrumbs” is open source software. The following people have contributed to this plugin. Contributors * [ Justin Tadlock ](https://profiles.wordpress.org/greenshady/) “X3P0: Breadcrumbs” er omsett til 3 språk. Takk til [omsetjarane](https://translate.wordpress.org/projects/wp-plugins/x3p0-breadcrumbs/contributors) for bidraga deira. [Omset “X3P0: Breadcrumbs” til ditt eige språk.](https://translate.wordpress.org/projects/wp-plugins/x3p0-breadcrumbs) ### Interested in development? [Les kjeldekoden](https://plugins.trac.wordpress.org/browser/x3p0-breadcrumbs/), sjekk [SVN-lageret](https://plugins.svn.wordpress.org/x3p0-breadcrumbs/) eller abonner på [utviklingsloggen](https://plugins.trac.wordpress.org/log/x3p0-breadcrumbs/) med [RSS](https://plugins.trac.wordpress.org/log/x3p0-breadcrumbs/?limit=100&mode=stop_on_copy&format=rss). ## Endringslogg #### 4.0.0 **Added** * **Rewrite Tags** block option, which lets you select which post types map to rewrite tags (e.g., `%category%`, `%author%`, etc.). Only post types with rewrite tags in their slugs appear as options. * **Post Taxonomies** block option, which lets you choose which taxonomy’s terms to display in the breadcrumb trail for single post views. * **Labels** block option, which lets you customize a subset of labels that most commonly need to be changed: - Home - Search Results - 404 * The Home label can also be edited directly from the content canvas. * Content-only editing support for the block. When enabled, the toolbar controls no longer appear. However, users can edit the Home label directly in the editor canvas. * Block supports: - `ariaLabel`: WordPress doesn’t display a UI control for this, but it’s possible to change the default `Breadcrumbs` label via the Code Editor view. - `shadow`: you can now add shadows—not sure how I missed adding this before. * Time-based breadcrumbs: - Hour, minute, and second archive breadcrumbs. - Posts with hour, minute, and seconds in their permalink structure now show those crumbs (assuming rewrite mapping is enabled). * A `JsonLinkedData` markup class for outputting JSON-LD breadcrumbs in the site head. This is not output by default, but developers can opt in. * Action hooks: - `x3p0/breadcrumbs/init` – Fires just before the plugin’s default service providers are registered. - `x3p0/breadcrumbs/register` – Fires just after the plugin’s default service providers are registered. - `x3p0/breadcrumbs/boot` – Fires just after the plugin’s default services providers have been booted. * Filter hooks: - `x3p0/breadcrumbs/resolve/query-type` – Allows filtering the primary query type used to determine the breadcrumbs for the current page. * `namespace` argument for the markup configuration, which allows controlling the HTML class prefixes or each element (defaults to `breadcrumbs`). **Changed** * A complete overhaul of the public-facing developer API. The plugin is no longer compatible with classes/functions earlier than 4.0.0 for people who were extending it with PHP. * Because the new Rewrite Tags and Post Taxonomies block options were added, the block no longer defaults to display a category for posts. This can be set manually by the user, within patterns, or within theme templates. * Under the hood, for the same reason as above, the PHP code no longer auto-sets the category taxonomy for posts when the permalink structure is set to `%postname%`. This was a relic from the code when users didn’t have direct control over the settings. * All block panels now use the Tools Panel component, which brings them up to date with the Core blocks in WordPress 6.9. * The icon-based block attributes have been merged into single attributes. The block is still backwards compatible with the old attributes with no current plans for removing their support: - `separator` and `separatorType` `separatorIcon` - `homePrefix` and `homePrefixType` `homeIcon` * The block preview in the content canvas now shows Home Ancestor Parent Current. This change was implemented so that users can better see the effects of removing the first and/or last breadcrumbs in the editor. * The `justifyContent` attribute is strictly limited to `left`, `center`, and ` right`. These have always been the only options. It’s just defined in `block. json` now. * The `404 Not Found` label has been changed to `Page not found` to match WordPress’s default output for 404 document titles. * The plugin now uses Composer for autoloading instead of the previous custom ` Autoload` class. * All nested elements for the block now use the `.wp-block-x3p0-breadcrumbs__` prefix instead of `.breadcrumbs__`. **Fixed** * Post taxonomy terms on single post views are no longer sorted by the plugin. This allows third-party plugins to manage the sorting. This is particularly important for SEO plugins that allow you to set a «primary» term for a post. * Correctly determine when a weekly archive is being displayed. **Removed** * Support for editing the Block layout. Previously, you could change how the block wrapped, but this was just UI clutter that served no practical purpose. * Call to `wp_set_script_translations()` for the block. WordPress already handles this through the normal block registration process. For complete version history, see the [changelog on GitHub](https://github.com/x3p0-dev/x3p0-breadcrumbs/blob/master/CHANGELOG.md). ## Community plugin This plugin is developed and supported by a community. [Contribute to this plugin](https://github.com/x3p0-dev/x3p0-breadcrumbs) ## Om * Version **4.1.0** * Last updated **2 månader sidan** * Active installations **200+** * WordPress version ** 6.8 eller nyare ** * Tested up to **6.8.5** * PHP version ** 8.1 eller nyare ** * Languages * [Dutch](https://nl.wordpress.org/plugins/x3p0-breadcrumbs/), [English (US)](https://wordpress.org/plugins/x3p0-breadcrumbs/), [Spanish (Chile)](https://cl.wordpress.org/plugins/x3p0-breadcrumbs/) og [Spanish (Spain)](https://es.wordpress.org/plugins/x3p0-breadcrumbs/). * [Omset til språket ditt](https://translate.wordpress.org/projects/wp-plugins/x3p0-breadcrumbs) * Tags * [block](https://nn.wordpress.org/plugins/tags/block/)[breadcrumbs](https://nn.wordpress.org/plugins/tags/breadcrumbs/) [navigation](https://nn.wordpress.org/plugins/tags/navigation/)[seo](https://nn.wordpress.org/plugins/tags/seo/) [trail](https://nn.wordpress.org/plugins/tags/trail/) * [Avansert vising](https://nn.wordpress.org/plugins/x3p0-breadcrumbs/advanced/) ## Vurderingar 5 out of 5 stars. * [ 4 5-star reviews ](https://wordpress.org/support/plugin/x3p0-breadcrumbs/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/x3p0-breadcrumbs/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/x3p0-breadcrumbs/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/x3p0-breadcrumbs/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/x3p0-breadcrumbs/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/x3p0-breadcrumbs/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/x3p0-breadcrumbs/reviews/) ## Contributors * [ Justin Tadlock ](https://profiles.wordpress.org/greenshady/) ## Hjelp Har du noko å seia? Treng du hjelp? [Sjå hjelpeforumet](https://wordpress.org/support/plugin/x3p0-breadcrumbs/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](http://a.co/02ggsr2)