Title: Breadcrumb NavXT
Author: John Havlik
Published: <strong>December 1, 2007</strong>
Last modified: December 22, 2025

---

Search plugins

![](https://ps.w.org/breadcrumb-navxt/assets/banner-772x250.png?rev=1927103)

![](https://ps.w.org/breadcrumb-navxt/assets/icon.svg?rev=1927103)

# Breadcrumb NavXT

 By [John Havlik](https://profiles.wordpress.org/mtekk/)

[Download](https://downloads.wordpress.org/plugin/breadcrumb-navxt.7.5.1.zip)

 * [Details](https://en-za.wordpress.org/plugins/breadcrumb-navxt/#description)
 * [Reviews](https://en-za.wordpress.org/plugins/breadcrumb-navxt/#reviews)
 *  [Installation](https://en-za.wordpress.org/plugins/breadcrumb-navxt/#installation)
 * [Development](https://en-za.wordpress.org/plugins/breadcrumb-navxt/#developers)

 [Support](https://wordpress.org/support/plugin/breadcrumb-navxt/)

## Description

Breadcrumb NavXT, the successor to the popular WordPress plugin Breadcrumb Navigation
XT, was written from the ground up to be better than its ancestor. This plugin generates
locational breadcrumb trails for your WordPress-powered blog or website. These breadcrumb
trails are highly customisable to suit the needs of just about any website running
WordPress. The Administrative interface makes setting options easy, while a direct
class access is available for theme developers and more adventurous users.

#### PHP Requirements

Breadcrumb NavXT 7.0 and newer require PHP7.0
 Breadcrumb NavXT 5.2 and newer require
PHP5.3 Breadcrumb NavXT 5.1.1 and older require PHP5.2

#### Features (non-exhaustive)

 * RDFa format Schema.org BreadcrumbList compatible breadcrumb generation.
 * Extensive breadcrumb customisation control via a settings page with appropriate
   default values for most use cases.
 * Network admin settings page for managing breadcrumb settings for all subsites
   with [configurable global priority](http://mtekk.us/archives/guides/controlling-breadcrumb-navxt-settings-from-the-network-settings-page/).
 * Built-in WordPress Widget.
 * Extensible via OOP and provided [actions](http://mtekk.us/code/breadcrumb-navxt/breadcrumb-navxt-doc/2/#action_reference)
   and [filters](http://mtekk.us/code/breadcrumb-navxt/breadcrumb-navxt-doc/2/#filter_reference).
 * WPML compatible (enhanced compatibility with WPML extensions plugin).
 * Polylang compatible (enhanced compatibility with Polylang extensions plugin).
 * bbPress compatible (enhanced compatibility with bbPress extensions plugin).
 * BuddyPress compatible (enhanced compatibility with BuddyPress extensions plugin).

#### Translations

Breadcrumb NavXT now supports WordPress.org language packs. Want to translate Breadcrumb
NavXT? Visit [Breadcrumb NavXT’s WordPress.org translation project](https://translate.wordpress.org/projects/wp-plugins/breadcrumb-navxt/).

## Screenshots

 * [[
 * This screenshot shows 5 different examples of breadcrumbs generated by Breadcrumb
   NavXT
 * [[
 * A screenshot of the General tab of the settings page
 * [[
 * A screenshot of the Post Types tab of the settings page
 * [[
 * A screenshot of the Taxonomies tab of the settings page
 * [[
 * A screenshot of the Miscellaneous tab of the settings page
 * [[
 * A screenshot of the Settings Import/Export/Reset form under the Help menu

## Blocks

This plugin provides 1 block.

 *   Breadcrumb Trail Displays a breadcrumb trail

## Installation

Breadcrumb NavXT can be installed from within WordPress’ administration panel. After
installing and activating the plugin, to get breadcrumb trails to display either
use the included widget, or call the breadcrumb trail in your theme (or child theme).
See the [Calling the Breadcrumb Trail](http://mtekk.us/archives/guides/calling-the-breadcrumb-trail)
article for more information on calling the breadcrumb trail.

To customise the breadcrumb trail you may edit the default values for the options
in the administrative interface. This is located in your administration panel under
Settings > Breadcrumb NavXT.

Please visit [Breadcrumb NavXT’s Documentation](http://mtekk.us/code/breadcrumb-navxt/breadcrumb-navxt-doc/)
page for more information.

## Reviews

![](https://secure.gravatar.com/avatar/f9721127aba23e56d62ba6b6706002703ae50286cce97dfcaf706814d2d74086?
s=60&d=retro&r=g)

### 󠀁[Breadcrumbs improved navigation](https://wordpress.org/support/topic/breadcrumbs-improved-navigation/)󠁿

 [juanmag](https://profiles.wordpress.org/juanmag/) October 4, 2025

Now users can easily see where they are in the site. It’s SEO-friendly too.

![](https://secure.gravatar.com/avatar/12e894f032fe66992d05ec9e09ca5c5387fa9ced32736883195034a7a7d6bb74?
s=60&d=retro&r=g)

### 󠀁[Exactly what I wanted](https://wordpress.org/support/topic/exactly-what-i-wanted-113/)󠁿

 [bleyjo](https://profiles.wordpress.org/bleyjo/) February 17, 2025

Ideal for my use, quick & custom breadcrumb navigation

![](https://secure.gravatar.com/avatar/3132b849bdce3ca18090661a338fba597f4dd8b6a16ba5e0334a2096fff05281?
s=60&d=retro&r=g)

### 󠀁[HUGE drawback](https://wordpress.org/support/topic/huge-drawback/)󠁿

 [skscomp](https://profiles.wordpress.org/skscomp/) August 23, 2024 1 reply

not a bad pluginbut a HUGE drawback is that it does not support shortcodesthis is
really inconvenient when you need to add breadcrumbs only to some pages

![](https://secure.gravatar.com/avatar/654845c3e93009b9aaa9fdbe58361d19d9a3633095fadd1802dacca9c451a9a7?
s=60&d=retro&r=g)

### 󠀁[doesn’t work after activation](https://wordpress.org/support/topic/doesnt-work-after-activation/)󠁿

 [warmy](https://profiles.wordpress.org/warmy/) July 7, 2024 1 reply

I couldn’t find a shortcode to install in the theme.

![](https://secure.gravatar.com/avatar/c6de0d682c7c8eb227267455a2533dcc06d54d567bbca6fca21cd80d527c1554?
s=60&d=retro&r=g)

### 󠀁[Perfect solution](https://wordpress.org/support/topic/perfect-solution-259/)󠁿

 [delrod](https://profiles.wordpress.org/delrod/) October 17, 2023

This plugin is a perfect solution and works so well! Please keep it up!!

![](https://secure.gravatar.com/avatar/690a4b2101415e5e077a6c9e5d4ad130dd631d64a87c54cd3d01b4c0276d03a4?
s=60&d=retro&r=g)

### 󠀁[breadcrumb navxt polylang does not work](https://wordpress.org/support/topic/breadcrumb-navxt-polylang-does-not-work/)󠁿

 [readysite](https://profiles.wordpress.org/readysite/) April 5, 2023

breadcrumb navxt polylang does not work for Homepage, this is a big problem, where,
for example, it was solved in other plugins, I found this one! But I want to evaluate
rationally if a site in one language plugin is an excellent solution. In any case,
thanks!

 [ Read all 132 reviews ](https://wordpress.org/support/plugin/breadcrumb-navxt/reviews/)

## Contributors & Developers

“Breadcrumb NavXT” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ John Havlik ](https://profiles.wordpress.org/mtekk/)
 *   [ hakre ](https://profiles.wordpress.org/hakre/)

“Breadcrumb NavXT” has been translated into 31 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/breadcrumb-navxt/contributors)
for their contributions.

[Translate “Breadcrumb NavXT” into your language.](https://translate.wordpress.org/projects/wp-plugins/breadcrumb-navxt)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/breadcrumb-navxt/),
check out the [SVN repository](https://plugins.svn.wordpress.org/breadcrumb-navxt/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/breadcrumb-navxt/)
by [RSS](https://plugins.trac.wordpress.org/log/breadcrumb-navxt/?limit=100&mode=stop_on_copy&format=rss).

## Change log

#### 7.5.1

Release date: December, 21st 2025

 * Behavior change: Removed deprecated `bcn_li_attributes` filter.
 * Bug fix: Fixed issue where the block could be used to generate breadcrumb trails
   that were not for the current resource.
 * Bug fix: Removed deprecated title length setting from settings page.
 * Bug fix: Fixed issue where XML settings import did not properly validate imported
   settings.

#### 7.5.0

Release date: December, 4th 2025

 * Behavior change: Refactored `bcn_breadcrumb_trail::post_hierarchy` to use `WP_Post`
   instance instead of id/type/parent parameters.
 * Behavior change: Removed deprecated function `breadcrumb_trail::title_trim` per
   deprecation schedule.
 * Bug fix: Fixed issue where the uninstaller would result in PHP errors and fail.
 * Bug fix: Fixed issue where “Hide on Home” option in the block did not function
   as intended.
 * Bug fix: Fixed typo in the block that resulted in web browser console warning.
 * Bug fix: Fixed issue where the block selector in block.json did not match the
   selector the block generated with.
 * Bug fix: Fixed issue where settings exporter failed to export settings.
 * Bug fix: Fixed issue where boolean options with false values could not be imported.

#### 7.4.1

Release date: January, 9th 2025

 * Bug fix: Fixed issue where the legacy widget was not available due to changes
   introduced in 7.4.0.

#### 7.4.0

Release date: December, 30th 2024

 * New feature: Added `bcn_admin_post_root_args` filter.
 * Bug fix: Fixed issue where the ignore the breadcrumb cache option within the 
   Breadcrumb Trail block resulted in the breadcrumb trail not getting generated
   on the home page.
 * Bug fix: Fixed issue where breadcrumb trails generated within the loop were improperly
   missing the home breadcrumb when on the home page.
 * Bug fix: Fixed issue breadcrumb-navxt textdomain is loaded too early (improved
   WordPress 6.7 support).
 * Bug fix: Improved `bcn_breadcrumb_trail::post_hierarchy()` resiliency to unexpected
   returns from `get_post()`.
 * Bug fix: Fixed translation text typos in Breadcrumb Trail block.

#### 7.3.1

Release date: June, 27th 2024

 * Bug fix: Fixed issue where $force parameter wasn’t passed into `bcn_breadcrumb_trail::
   fill()` within `bcn_display*()` functions.
 * Bug fix: Fixed improper textdomain existing within `adminKit`.
 * Bug fix: Fixed issue with `$force` parameter where when it is not set the homepage
   breadcrumb would use the wrong template when calling the breadcrumb trail within
   the loop.

#### 7.3.0

Release date: February, 9th 2024

 * Behavior change: `bcn_display_json_ld()` now returns unescaped Unicode characters.
 * Behavior change: `$force` parameter in `bcn_display*()` functions is now passed
   to `bcn_breadcrumb_trail::fill()` allowing generation of trails within the loop
   for the current loop item instead of the parent page/resource.
 * New feature: Breadcrumb Trail block rewritten to have feature parity with Breadcrumb
   NavXT Widget.
 * New feature: Breadcrumb Trail block supports basic styling within block editor.
 * Bug fix: Fixed error where $outer_template argument was dropped within `breadcrumb_navxt::
   display()`.
 * Bug fix: Fixed issue where boolean settings were not exported/imported properly.
 * Bug fix: Fixed cause of PHP error in `bcn_breadcrumb_trail::maybe_add_post_type_arg()`
   when 3rd party code breaks the WP API.
 * Bug fix: Added check for proper queried object type for author archives.

#### 7.2.0

Release date: February, 9th 2023

 * Behavior change: Settings reset sets option entry to blank array, consistent 
   with the change to only storing non-default values in the database.
 * New feature: Added `bcn_display_separator` filter.
 * New feature: Add per setting indication if Network wide settings are overriding
   the local setting.
 * Bug fix: Improved compatibility with PHP8.1.
 * Bug fix: Fixed PHP errors caused by unexpected entries in WP Post Types array.
 * Bug fix: Settings help menu now shows up in the network settings page.
 * Bug fix: Fixed cause of “file not found” error on the import/export/reset form
   in the network settings page.

#### 7.1.0

Release date: July, 17th 2022

 * Behavior change: BCN_SETTINGS_FAVOR_* constant behavior changed to take advantage
   of settings changes in 7.0.
 * Behavior change: Settings page now warns if it detected CPTs that were added 
   too late.
 * New feature: Added bcn_before_loop filter which runs at the top of bcn_breadcrumb_trail::
   display_loop().
 * New feature: Added JSON formatted settings import and export (successor to the
   old XML settings import/export format).
 * Bug fix: Fixed PHP error caused by term archives that don’t know the active term.
 * Bug fix: Fixed PHP error caused by introduction of namespacing in the legacy 
   XML settings importer and exporter.
 * Bug fix: Explicitly set option autoload values, avoiding inappropriate default
   autoload values being used.

#### 7.0.2

Release date: January, 4th 2022

 * Behavior change: Allow value of `Hhome_template`, `Hhome_template_unlinked`, `
   hseparator`, and `hseparator_higher_dim` to be overridden via `bcn_settings_init`.
 * Bug fix: Fixed cause of “Sorry, you are not allowed to access this page.” message
   when attempting to visit the settings page.

#### 7.0.1

Release date: December, 27th 2021

 * Behavior change: Moved `bcn_settings_init` filter to before establishing default
   setting values. This filter is no longer capable of changing the default values
   of settings.
 * Behavior change: Moved setup of defaults to 9000 priority, intending to cover
   the majority of plugins that add CPTs.
 * Bug fix: Fixed compatibility issues with PHP5.6.
 * Bug fix: Fixed PHP error caused by some return value of page_ settings.
 * Bug fix: Fixed PHP error caused by non settings settings in array passed into`
   adminKit::settings_to_opts`.
 * Bug fix: Fixed issue with `bcn_allowed_html` not covering admin interface elements(
   mapped `bcn_allowed_html` to `mtekk_adminkit_allowed_html`).

#### 7.0.0

Release date: December, 17th 2021

 * Behaviour change: Within the `bcn_breadcrumb_trail` object instead of passing
   term id and taxonomy, a WP_Term object is passed instead.
 * Behaviour change: Attachments now use parent post type for post type argument.
 * New feature: Moved to adminKit 3.0
 * New feature: Core `bcn_breadcrumb_trail object` now supports multi dimensional
   trails.
 * New feature: Added `bcn_opts_update_to_save` filter.
 * Bug fix: Fixed parameter order issue in REST controller that resulted in PHP 
   Deprecated message in PHP8.
 * Bug fix: Updated REST controller endpoint registration for better WordPress 5.5
   + compatibility.
 * Bug fix: Fixed compatibility issue with Widget settings not saving properly in
   WordPress 5.8.
 * Bug fix: Fixed issue with the position count parameter within bcn_display when
   outputting a trail in reverse order.

## Meta

 *  Version **7.5.1**
 *  Last updated **4 months ago**
 *  Active installations **800,000+**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.0 or higher **
 *  Languages
 * [Catalan](https://ca.wordpress.org/plugins/breadcrumb-navxt/), [Chinese (China)](https://cn.wordpress.org/plugins/breadcrumb-navxt/),
   [Czech](https://cs.wordpress.org/plugins/breadcrumb-navxt/), [Danish](https://da.wordpress.org/plugins/breadcrumb-navxt/),
   [Dutch](https://nl.wordpress.org/plugins/breadcrumb-navxt/), [Dutch (Belgium)](https://nl-be.wordpress.org/plugins/breadcrumb-navxt/),
   [English (Australia)](https://en-au.wordpress.org/plugins/breadcrumb-navxt/),
   [English (Canada)](https://en-ca.wordpress.org/plugins/breadcrumb-navxt/), [English (New Zealand)](https://en-nz.wordpress.org/plugins/breadcrumb-navxt/),
   [English (South Africa)](https://en-za.wordpress.org/plugins/breadcrumb-navxt/),
   [English (UK)](https://en-gb.wordpress.org/plugins/breadcrumb-navxt/), [English (US)](https://wordpress.org/plugins/breadcrumb-navxt/),
   [Estonian](https://et.wordpress.org/plugins/breadcrumb-navxt/), [Finnish](https://fi.wordpress.org/plugins/breadcrumb-navxt/),
   [French (France)](https://fr.wordpress.org/plugins/breadcrumb-navxt/), [German](https://de.wordpress.org/plugins/breadcrumb-navxt/),
   [Greek](https://el.wordpress.org/plugins/breadcrumb-navxt/), [Italian](https://it.wordpress.org/plugins/breadcrumb-navxt/),
   [Japanese](https://ja.wordpress.org/plugins/breadcrumb-navxt/), [Korean](https://ko.wordpress.org/plugins/breadcrumb-navxt/),
   [Lithuanian](https://lt.wordpress.org/plugins/breadcrumb-navxt/), [Persian](https://fa.wordpress.org/plugins/breadcrumb-navxt/),
   [Polish](https://pl.wordpress.org/plugins/breadcrumb-navxt/), [Portuguese (Portugal)](https://pt.wordpress.org/plugins/breadcrumb-navxt/),
   [Russian](https://ru.wordpress.org/plugins/breadcrumb-navxt/), [Spanish (Chile)](https://cl.wordpress.org/plugins/breadcrumb-navxt/),
   [Spanish (Colombia)](https://es-co.wordpress.org/plugins/breadcrumb-navxt/), 
   [Spanish (Spain)](https://es.wordpress.org/plugins/breadcrumb-navxt/), [Spanish (Venezuela)](https://ve.wordpress.org/plugins/breadcrumb-navxt/),
   [Swedish](https://sv.wordpress.org/plugins/breadcrumb-navxt/), [Turkish](https://tr.wordpress.org/plugins/breadcrumb-navxt/),
   and [Ukrainian](https://uk.wordpress.org/plugins/breadcrumb-navxt/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/breadcrumb-navxt)
 * Tags
 * [block](https://en-za.wordpress.org/plugins/tags/block/)[breadcrumb](https://en-za.wordpress.org/plugins/tags/breadcrumb/)
   [breadcrumbs](https://en-za.wordpress.org/plugins/tags/breadcrumbs/)[navigation](https://en-za.wordpress.org/plugins/tags/navigation/)
   [trail](https://en-za.wordpress.org/plugins/tags/trail/)
 *  [Advanced View](https://en-za.wordpress.org/plugins/breadcrumb-navxt/advanced/)

## Ratings

 4.6 out of 5 stars.

 *  [  109 5-star reviews     ](https://wordpress.org/support/plugin/breadcrumb-navxt/reviews/?filter=5)
 *  [  8 4-star reviews     ](https://wordpress.org/support/plugin/breadcrumb-navxt/reviews/?filter=4)
 *  [  5 3-star reviews     ](https://wordpress.org/support/plugin/breadcrumb-navxt/reviews/?filter=3)
 *  [  2 2-star reviews     ](https://wordpress.org/support/plugin/breadcrumb-navxt/reviews/?filter=2)
 *  [  8 1-star reviews     ](https://wordpress.org/support/plugin/breadcrumb-navxt/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/breadcrumb-navxt/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/breadcrumb-navxt/reviews/)

## Contributors

 *   [ John Havlik ](https://profiles.wordpress.org/mtekk/)
 *   [ hakre ](https://profiles.wordpress.org/hakre/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/breadcrumb-navxt/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=FD5XEU783BR8U&lc=US&item_name=Breadcrumb%20NavXT%20Donation&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted)