These are a few Frequently Asked Questions, and/or frequent search queries and answers that hopefully help solve them. This by no means is an exhaustive list.
Q: How do I remove the current item from the breadcrumb trail. E.g. the breadcrumb trail is Home > Category A > Category B > Current Page, and I want to remove “Current Page”

A: True breadcrumb trails include all of the breadcrumbs, including the current page. Therefore there is no built in option for removing the current item. Typically, the motivation behind removing the current item is due to having the page title too close to the breadcrumb trail. Good design will have proper spatial and visual separation between the breadcrumb trail and the page title. This includes proper sizing of both items which alone can provide enough separation.

However, removing the current item isn’t impossible, but it is a task left to the reader. You can also use Breadcrumb NavXT uManager Extension plugin or the Breadcrumb NavXT Remove Current Item Extension plugin.

Q: How do I remove the breadcrumb trail from the home page?

A: Wrap the calling code with an if block that tests is_front_page(). E.g. use:

<?php if(function_exists('bcn_display') and !is_front_page()):?>
<div class="breadcrumbs" typeof="BreadcrumbList" vocab="https://schema.org/">
<?php bcn_display();?>
<?php endif; ?>

Q: My breadcrumb trail on all my posts is for the same post.

A: This is caused by a secondary loop in your theme which is not behaving “nicely”. The secondary loop should not modify the variable $post, and if it does, the variable $post should be returned to it’s original state afterward. The best way of accomplishing this is to call wp_reset_query() before your Breadcrumb NavXT calling code (most likely bcn_display()).

Q: How do I remove the home/blog breadcrumb from the breadcrumb trail?

A: Prior to Breadcrumb NavXT 3.0, there was no easy way to remove the home breadcrumb from the breadcrumb trail. Simply emptying the contents of the “Home Title”/”Blog Title” options will not remove the home breadcrumb. In Breadcrumb NavXT 3.0 the proper way to not include the home breadcrumb is to use the “Home Breadcrumb” option and set it to “Leave the home breadcrumb out of the trail.”.


277 thoughts on “FAQ

  1. Hello.
    Have this:
    Main (link) -> Page 1 (link) -> Page 2 (link) -> Page 3 (not link)

    Main (link) -> Page 1 ( NOT link) -> Page 2 (link) -> Page 3 (not link)

  2. Hi I installed this plugin and when I used this code

    It just shows the current page position..Its parents are not shown.I want to use it for custom post/taxonomy and for pages and.. How to do this??

    • Prakash,

      If you are going to include code in your comment, please use the HTML code tags, otherwise WordPress will strip out the code.

      If you are only getting the current item in the breadcrumb trail (no home/blog breadcrumb) then you’ve likely turned off those items in the settings page. For the page post type only page parents are allowed to be used as the hierarchy (use a custom post type if you need a hierarchical post type and want to use a taxonomy hierarchy with it), and as long as the page has a parent it should show up in the breadcrumb trail.

      -John Havlik

  3. Hello,
    I’m wondering if your WP plugin supplies RDFa breadcrumbs. Yoast has advised my client to add them, but the RDFa Breadcrumb plugin is 10 months old and only compatible up to WP 3.5.2 (and many fewer downloads than yours). Keeping my fingers crossed! :)
    THank you,

    • Bridget,

      While Breadcrumb NavXT does not do this automatically for you, it is possible to do. You will have to modify all of the breadcrumb template settings to include the requisite extra markup that RDFa requires. I just ran though setting this up on this site and will write up a procedure and post it tomorrow or Friday (will be less work that what I had to do as you will have a settings file you can import to do most of the work for you).

      -John Havlik

      • Hi,

        have you done this script? Can you forward me this?

        It would be very cool, so the breadcrumbs would appear in Google SERP.
        I have implement it at above website, but i cannot find how to overwrite it for being RDFa combatible.


  4. Hi John,

    Great stuff. I’m currently using your Breadcrumb NavXT Remove Current Item Extension plugin but for some reason it stopped working and the current post/page title keeps displaying. I’m wondering if its due to compatibility issues with WordPress 3.8.1.

    Any thoughts?

    • This should still work. Note that I did a push to update things for Breadcrumb NavXT 5.0’s internal structure. However, the old code should have still worked.

      -John Havlik

  5. Hiya, running the utterly brilliant plugin on Graphene; for some reason the links in the trail don’t pick up the formatting – just a white background. I tried switching off the header trail and using the widget but the widget formatting was all over the place. Because I’m a novice I haven’t messed about with any code anywhere as it terrifies me. Any suggestions for a fix very much appreciated.

    • Recto,

      What formatting are you referring to? Breadcrumb NavXT itself does not supply any CSS styling, so you need to apply that through your theme’s style.css or other applicable method depending on your theme setup. You will want to use a HTML/CSS inspector such as Firebug in Firefox or the built in inspector in Chrome to investigate what CSS rules are being applied to the breadcrumbs.

      -John Havlik

  6. The plug-in looks interesting, and we’d like to use it on our research computing site for our documentation pages. But no others. Is there a way to enable the breadcrumb function only for this ‘page branch’ and its children, but nowhere else in the site?


  7. Hi I have breadcrumb like this

    Section A / Section B / Section C / Section D

    I want to insert Section X become:

    Section A / Section B / Section X /Section C / Section D.

    How I supposed to do that?

    • The only valid way of doing this right now is to have Section X be child of Section B and the parent of Section C. Otherwise, to place truly custom breadcrumbs into the breadcrumb trail you will need Breadcrumb NavXT Menu Magic (not yet released, but will be within a few days).

      -John Havlik

      • Any news on the release of Breadcrumb NavXT Menu Magic? Will it be able to rewrite a custom post type slug from portfolio_page to portfolio? If not is there a code snippet that works with Breadcrumb NavXT that will do this?

        • Breadcrumb NavXT Menu Magic has been released, though I have not publicly announced it’s release. It allows you to generate custom and arbitrary hierarchies using a WordPress menu. It won’t actually change slugs of anything unless that’s what the resource’s slug is (e.g. you can change the slug in a change from an archive that WordPress generates for you to a page you create).

          -John Havlik

  8. Hello,

    I seem to be having an issue with the breadcrumb trail..If I enter a page I get:
    Home > Page1
    and everything is ok but if I go to an extra page then the trail breaks and it shows:
    Home Page1 >> Page2
    and so on. Is there a way to fix this?


    • Just download the file from GitHub, upload it to your wp-content/plugins folder for your WordPress install. Then activate the plugin. It should just work.

      -John Havlik

  9. Hi…
    Still not sure how to implement this.
    Q: How do I remove the breadcrumb trail from the home page?

    Can you please guide me where should put those code?

    <div class="breadcrumbs">
    <?php if(function_exists('bcn_display') && !is_front_page())

    • You would place that code wherever your current call to bcn_display(). This is probably in your header.php file of your current theme or child theme.

      -John Havlik

  10. Hi,
    currently I have this breadcrumb in my site. I just want to “hide”
    level 2 and level 3 of my hierarchy. Is there a way to do it?

    from: Home / Bares e Restaurantes / Minas Gerais / Belo Horizonte / Bares Minas BH

    to: Home / Bares e Restaurantes / Bares Minas BH


  11. Fernando:
    I just want to “hide” level 3 and level 4 of my breadcrumb. Is there a way to do it?from: Home / Bares e Restaurantes / Minas Gerais / Belo Horizonte / Bares Minas BHto: Home / Bares e Restaurantes / Bares Minas BHRegards,

  12. Hi there,

    Installed and doesn’t work. Updated with latest WP and theme is KingSize.

    Any special instructions? Added to the Custom Header HTML section in theme options: This area is used for when you need to include new scripts into your header without needing to make changes to the “header.php” file. It’s recommended you use this to avoid overwriting your changes when updating the template files during updates.

    Any help please?

    • Since I am not familiar with the KingSize theme, I’m going to assume the Custom Header HTML theme option does not accept PHP (if it did that would be bad). You have two good options here: Either use the included widget, and place in the appropriate widget area. Or, create a child theme for KingSize where you redefine the header.php file to include the Breadcrumb NavXT calling code in the appropriate area.

      -John Havlik

  13. Hi,
    I currently have my breadcrumb typically as:
    Home>Parent Page 1>Information page 1
    I have Parent Pages 1-10 and Information pages 1…….15+ for each of the Parent Pages. The Parent Pages, are just blank, and allow me to keep my 100+ pages organized within WP.
    So what I need to do is to somehow remove completely, all Parent Pages from the Breadcrumb. Is there an easy way of doing this please?
    Many thanks in advance.

  14. Thanks for your reply. There is a reason why I am using pages and not posts (and hence not using categories to create the menu). The reason being that there is another part of the site which contains all “live” information, for which I use posts. The pages part of the site is for reference information only. I could use posts instead of pages, but then I would have over 200 posts to manage and organize. What I am doing is probably not the most elegant solution, but it kinda works for me!

    Thanks for the link to the code, but excuse my ignorance, could you explain where I put it and how I use it please?
    Many thanks,

    • Ken,

      Go to the Breadcrumb NavXT settings page, under the General tab, look for the “Home Template” and “Home Template (unlinked)” settings. Replace instance of %title% and %htitle% with Home.

      -John Havlik

  15. I have a quick question, on a site I’m working on, the radio button for “Blog Breadcrumb” is greyed out and I can’t seemed to find a solution anywhere. I’m trying to get the blog page to appear in the breadcrumbs (the site has a static main page). I’ve looked through the documentation, the faqs and the plugin page on wordpress.org, and I couldn’t find a similar question.

    I’m using the stock function from your documentation, is there some code I need add to get the blog page to show up? I’m using the 5.1.1 version, which I think is the most recent. Thanks for the great plugin by the way, it works just the way we wanted it to, except for this one issue.


    • Hi Scott,

      The Blog Breadcrumb settings become available when under Settings > Reading the “Front page displays” setting is set to “A static page (select below)”. Note that one of the two pages (front page or posts page) must be set for that setting to work.

      -John Havlik

  16. hello,

    I would like to have the current page breadcrumb be a larger font size the other breadcrumbs. Is that possible?

    Nate Gunn

  17. Hi John!
    I’ve posted this question in some other place… that I couldn’t find anymore.
    So, sorry, I’ll post again.
    The breadcrumb appears exactly as I want in all the pages linked to the main menu.
    But blog posts, services and other internal pages doesn’t have breadcrumb trail.
    What I’m doing wrong?

    • Hi Saul,

      Are these internal pages using a different theme template than the other pages? If so, you may need to check how you are calling the breadcrumb trail. How are you calling the Breadcrumb NavXT breadcrumb trail (are you using the widget, or are you calling bcn_display(), what file did you place the call to bcn_display() in)?

      -John Havlik

      • Hi John!
        Thanks for your answer (and sorry about my delay).
        Well, I’m pretty new with WordPress and PHP… so I don’t understand your question. I just installed the plugin checked, or unchecked some options and add some CSS. That’s all.
        Do I have to use the templates of the “Post Types” tab or something (and where)?
        Thanks again!

  18. Hello John…
    It took me some time and some headaches :) but finally I understood your explanation and the breadcrumb trail is working in the internal pages.
    But I have one more question:
    Is it possible to remove one part of the path?
    Mean: my breadcrumb trail is Home>Services>Services>SERVICE
    One of this “Services” is unnecessary – or better: I must remove it – because it points to a page that I don’t want to show, but that is part of the template (archive).
    So… is it possible?
    What can I do?
    Thanks in advance.

  19. I have woocommerce in my website.
    When I activate the code in archive-product.php I see the breadcrumbs in the main product list page and in all the products subcategories.
    But since I also need to put the code in list-post.php (templates/list-post.php) in order to have the breadcrumbs activated in the blog area, the result is that I have a duplicated breadcrumbs effect in all the woocommerce product subcategories (not in the main product list).

    • Erin,

      Not being familiar with your theme, I would assume that there is another file, that isn’t in templates/ that you can add the calling code to. I recommend placing the calling code in your theme’s header.php file, though I understand that not all themes use that file the same way, and that may not be the best file for you.

      -John Havlik

  20. Hi

    I’m using Breadcrumb NavXT with WPML . I have a problem to select different root page for the Portfolio Item. Only one language is saved.

    Could this be solved with your extension Breadcrumb NavXT WPML?

    Thanks a ot

  21. I am using the Breadcrumbs NavXT plugin and have one question. In the Breadcrumb trail it is listing:

    Parent menu item > child, child, child

    I would like it so their is no link on the Parent menu item (just the child items). How can I achieve this?

  22. Hi we are running woo commerce and the breadcrumbs I have set some conditionals up, and they seem to work but for one, the is_cart() conditional. The code I am using is
    <div class="breadcrumbs">
    <?php if(function_exists('bcn_display') && !is_front_page || !is_cart() || !is_checkout())

    Perhaps I am still doing something wrong? If you could take a look, I would appreciate it, thank you!

    • Personally, I always like to use extra parentheses around logic expressions when switching between AND and OR (it’s a habit I picked up in my digital design courses).

      To me this reads as:

      Do this thing if: the function ‘bcn_display’ exists and I’m not on the front page, OR if this is not the cart, OR if this is not the checkout page.

      The problem here is twofold. First, checking for bcn_display doesn’t happen for every case. Second, the inversion is messing with your logic (don’t worry many people get tripped up by this). Either surround the checks for the three pages with parentheses and invert the whole thing (e.g. !(is_front_page() || is_cart() || is_checkout())). Or, apply De Morgan’s Law and change your ORs to ANDs (e.g. (!is_front_page() && !is_cart() && !is_checkout())).

      -John Havlik

  23. Hello! This is great except for one issue. The breadcrumbs are in a sidebar widget. Which is fine on a computer, but on mobile readers, my sidebar is way down at the bottom. Is there a way I can move it to show right above the post title like most other blogs I’ve seen? I am a total rookie, so if you need me to add or remove code, please tell me exactly where to go. Thanks!!

    • Hi Wendy,

      The included widget is only one of many ways to call the breadcrumb trail. To have more flexibility in the location of the breadcrumb trail, you will want to take a look at Calling the Breadcrumb Trail.

      As to the exact location of where to place the calling code, that depends on where you want the breadcrumb trail to show up. Additionally, which files you need to edit depend on your theme. Traditionally, the header.php is where you want to place the calling code, but this is not always the case.

      -John Havlik

  24. I would like to have my breadrcumb like that:
    Home -> Blog -> Category -> Post
    Blog string is not appear now:
    Home -> Category -> Post

    I have version:

    Also I’ve set: “Place the blog breadcrumb in the trail.” in settings.

    I can see that was bug:
    5.5.2 [9-30-2016]:
    Bug fix: Fixed issue where the “blog breadcrumb” setting does not affect the inclusion of the blog breadcrumb in the breadcrumb trail.

    Is this bug really fixed ?

    Thank you

    • Marek,

      That particular bug fixed in 5.5.2 manifested itself in the inability to disable the Blog breadcrumb. In 5.5.1 and 5.5.0, Breadcrumb NavXT would always display the blog breadcrumb, regardless of the setting.

      Check to ensure under Settings > Reading, that you have a page selected for the “Post Page”, without one, Breadcrumb NavXT can not add the blog breadcrumb. Note that the settings page will not disable the setting in versions prior to 5.6.0 (forthcoming release). Thus, visually, it may appear you can tell Breadcrumb NavXT to include the blog breadcrumb, but since there isn’t a resource to link to, it can’t actually add it.

      -John Havlik

      • Thank you,
        I have not set my blog page under Settings > Reading -> Post Page, because its collides with my theme settings. Post page is set in theme option (uplift /swift).
        Is there any way how to tell NavXT which page is my “Post Page” ?

        • I’m sorry for typo.
          I mean:
          Is there any OTHER way to tell NavXT which page is “Post Page” as Settings -> Reading -> Post Page ?

          • Hi Marek,

            Currently, the way bcn_breadcrumb_trail::do_root() is written, there is not a very clean way of doing this. The best way would be to write a hook into the bcn_after_fill action and inject the Blog breadcrumb where you want it. Note that you will have to check that the conditions are correct (e.g. that is makes sense to add the Blog breadcrumb for the current resource).

            -John Havlik

  25. Hi there!
    In a shopping site, if the product is in category 1 and 2, when you go Shop>category 1>product, the breadcrumb shown in my site is Shop>category 2>product. Can’t it be dynamic, showing the category you clicked to get to the product? or can’t I choose which one to be shown?
    Many thanks

  26. Hi:

    This is a presale question. I hope I i will be able to explain myself well enough. I have a portfolio and I have 4 categories. Many of the portfolio items belong to more than one category. I have created a portfolio showcase with a filter element so user can see separated categories when clicks on a filter item. But Breadcrumb NavXT doesn’t recognize the clicked category path! When a portfolio item has more than one category, the path to portfolio item is always the same, doesn’t matter wich category user clicked on.
    So my question is if this extension Breadcrumb NavXT Paths will solve this issue. In my portfolio, filter is an ajax filter. My theme is Booklyn and It includes Visual Composer framework (so portfolio is created with visual composer).
    Will I see right clicked category if I buy BN Paths extension?


    • Unfortunately, if the category filter is applied via a JavaScript action the breadcrumb trail will likely remain unaffected. If via AJAX you reload a portion of the page, it is possible that the breadcrumb trail could change. However, currently, Breadcrumb NavXT Paths depends on the HTTP referrer to hint at a specific taxonomy term to use in the breadcrumb trail.

      In short, no I do not think Breadcrumb NavXT Paths (in its current form) will help you achieve what you are looking for.

      -John Havlik

  27. Hi John
    do it’s possible to change the description words before the trail?
    It appears: “You are here: #100parole>>L’Italia che affonda: un giovane su 5 non studia né lavora”, when “#100parole” is the category name. I wish to change “you are here” with an Italian word, considering that the website is in the Italian language.
    where can I modify the setup?
    thank you, best regards

    • Hi Mauro,

      If you are using the included Breadcrumb NavXT widget to display the breadcrumb trail, look for the “Text to show before the trail:” text field in the widget settings. That may have the “You are here:” phrase.

      Otherwise, the “You are here:” string is likely being added by your theme. If that is the case, you will need to find where that string is in your theme and modify it to the desired string.

      -John Havlik

  28. Hi John

    I’m trying to get my custom taxonomy breadcrumb to display as follows:

    Home -> Taxonomy -> Term

    At the moment it gives the post type like this:

    Home -> Custom post type -> Term


    • Hi Alex,

      Currently, WordPress does not support the concept of a taxonomy archive that contains all the posts that are members of any of the taxonomy’s terms. Thus, what you’re asking for isn’t something Breadcrumb NavXT supports out of the box. The best Breadcrumb NavXT can do is associate a taxonomy/taxonomy term with a post type and include the post type’s archive in the trail.

      You can manually inject the breadcrumb for the Taxonomy, if you wish (though I don’t know what you would have it link to), using the bcn_after_fill. action. See the documentation for two examples of how to use bcn_after_fill. Additionally, the BuddyPress Extensions plugin may be worth looking at as well—it uses bcn_after_fill to modify the contents of the breadcrumb trail.

      -John Havlik

  29. Hi John,

    Thanks for your good plugin, I love this very much.

    I have read the FAQ:
    Q: How do I remove the breadcrumb trail from the home page?

    But I just want to show the breadcrumb trail on the portfolio, so also how to remove the breadcrumb trail from the other page, like contact page, about page?

    Looking forward to your kindly reply.

    Best regards.


    • Hi David,

      Controlling what pages the breadcrumb trail is displayed on comes down to how you call the breadcrumb trail. If you are placing code that calls bcn_display() somewhere in your theme’s files, then you can wrap it with an if condition that checks if the page is correct to display the breadcrumb trail. Also see the last examples presented in Calling the Breadcrumb Trail on how to deal with exclusion on multiple pages (just invert the logic to explicitly allow only on a few pages).

      -John Havlik

  30. Hi John,

    Currently, the breadcrumbs are all in caps, and Im trying to make them Title sensitive, so instead of this:

    I should get:
    LeadEPC / Services

    Is there a setting Im missing or is it done with CSS, and if so, can you help me out with the code please?

    • Hi Clyde,

      This is likely something your theme is doing. To determine if this is being caused by CSS, or by something else, use your web browser’s built in inspector to see what HTML is being generated by Breadcrumb NavXT. If the titles are all capitalized, then there is some plugin or the theme itself, is modifying the titles (assuming that the titles in the WordPress editor are not all capitalized). If the titles are correct in the HTML, then the inspector should show what CSS styling is being applied that is causing the titles to be capitalized.

      -John Havlik

  31. Hello,

    is it possible to exclude pages id’s to be listed in breadcrumb ?
    our site has a bad page structure and i wish to exclude different ids.

    like we have

    – page – pageone – content
    – page – pagetwo – content
    – page – pagethird – content
    – page – pagefour – content

    so i want “pagenbr” to not be listed in the breadcrumb.

    thanks in advance for your help

  32. Hi,
    How can i wrap the current item in a span like the others in order to target it in the css.
    currently it’s just a string of text appended at the end of the main wrapper and no way to target it.

    • You can add span tags around the %htitle% in the unlinked breadcrumb templates. Otherwise, you can upgrade to the just release 6.2.1 which re-introduces this behavior in the default settings.

      -John Havlik

Comments are closed.