Fork me on GitHub

Release Notes


Release Date: 25 May 2022

  • Upgrade to Bloomreach Experience Manager 15.
  • Added a 15.0.0 demo project.


Release Date: 2 September 2021

  • HIPFORGE-401
    NPE when using xpages (hst:componentconfigurationid expected)
  • HIPFORGE-411
    Make the plugin Page Delivery API compatible


Release Date: 2 June 2021

  • HIPFORGE-406
    Avoid doubling of breadcrumb items in case of a content based breadcrumb in combination with _index_ sitemap item.


Release Date: 8 January 2021


Release Date: 29 May 2020

  • Upgrade to Bloomreach Experience Manager 14.
  • The artifact's groupId was changed from org.onehippo.forge to org.bloomreach.forge.breadcrumb (but no repackaging of Java classes though).


Release Date: 12 March 2019

  • Upgrade to Bloomreach Experience Manager 13.


Release Date: 25 Sep 2018

  • HIPFORGE-164
    Upgrade to Hippo version 12.
  • HIPFORGE-165
    Don't render a link for the last item in the breadcrumb (but render it as plain text).
  • HIPFORGE-166
    Add configurable behaviour options for items that point to 404 (pagenotfound). 2 options are supported, hide the items or render them as plain text (no link).


Release Date: 12 January 2018

  • HIPFORGE-126
    Implementation of BreadcrumbItem#equals and #hashCode methods, for convenience, supporting easier modifications of the list returned by Breadcrumb#getItems(), in a custom component.
  • HIPFORGE-127
    Add feature to create a breadcrumb without menu item involved, activated with the 'breadcrumb-add-content-based' component parameter, see configuration page.


Release Date: 24 August 2017

    Upgrade to Hippo version 11.2.
    Note: no longer possible to instantiate a BreadCrumbProvider as private component property at constructor time. The private property can be kept, but should be instantiated in the #init() method of the component.


Release Date: 14 Februari 2017

  • HIPPLUG-1412
    Fix double breadcrumb items by not adding a trailing item if the bean for the last menu based item is the same as current bean.


  • Breadcrumb plugin now uses HST 3.2.0, part of Hippo 10.2.


  • Better extendibility of the BreadcrumbProvider.
  • Added JavaDoc, removing IDE warnings


  • Use bean#getLocalizedName instead of bean#getName when creating a breadcrumb item from a hippobean.


  • Breadcrumb plugin now uses hst tag 2.22.00.
  • Fixed double item: if a menuitem directly linked to a document, both the menuitem and the document itself were added.


  • Possibility to set a flag 'addTrailingDocumentOnly' that changes behaviour of the breadcrumb provider: it does not look at path between current document and deepest expanded menu item but just adds the document.
  • Add a fallback determination of the path between current document and deepest expanded menu item by looking at path information instead of bean ancestors, applicable for faceted navigation on a menu item.


  • Support to configure multiple menus to base the breadcrumb on. The component parameter 'breadcrumb-menu' is renamed to 'breadcrumb-menus', a comma separated list, defaulting to a list with single item 'main'.


  • A breadcrumb structure is constructed by determining the deepest expanded item from a menu for the first part and from the resolved sitemap item belonging to the current request for the trailing part. The breadcrumb is put on the request by attribute name 'breadcrumb' so a view can access it.
  • The menu name is configurable by component parameter 'breadcrumb-menu' and defaults to 'main'.
  • A separator is configurable by component parameter 'breadcrumb-separator' and defaults to '»'.