EEA Faceted Navigation

The EEA Faceted Navigation (FacetedNav) gives you a very powerful interface to improve search within large collections of items. No programming skills are required by the website manager to configure the faceted navigation interface, configuration is done TTW. It lets you gradually select and explore different facets (metadata/properties) of the site content and narrow down you search quickly and dynamically.

On the contrary, plone collections are static, in a way that the site admin decides the search criteria and the end user is not able to further sort or filter the presented results.

FacetedNav is fully customizable, site admin may decide that some criteria (facets) must have fixed values while other may be presented as filter options to the web visitor.

FacetedNav may very well replace the standard collection content type, since it covers same functionality and it adds a lot more features.

FacetedNav can also be used as an advanced search for your site.


Latest releases of this package (10.0+) introduced a lot of major changes in order to make it work with Plone 5. Thus, please intensively test it before upgrading on Plone 4 deployments.

Upgrade to version 10.0+

  • Within “Plone > Site setup > Add-ons” click on upgrade button available for EEA Faceted Navigation;
  • Only if the above step didn’t work for you. Within “Plone > Site setup > Add-ons” uninstall EEA Faceted Navigation and Install it again;
  • If you have third-party Faceted Navigation Widgets (registered outside eea.facetednavigation package) you will need to upgrade them to z3c.form and explicitly register JS/CSS resources within registry.xml/cssregistry.xml/jsregistry,xml Take faceted text widget as an example;

Main features

It comes with plenty of configuration options and features like:

  1. Easy customizable GUI via drag-n-drop, no restart needed.
  2. Facets can be set to fixed default values and hidden.
  3. Facets can be placed in standard search or extended search panels, to not intimidate novice users and have cleaner interface
  4. Facets can be displayed via several widgets like select, radio, text input, tag cloud, date range and more
  5. Expandable and collapsible widgets with many values
  6. Automatically counts number of content items beside each facet value
  7. Possibility to show or hide the options with zero results (show only the facets which return content)
  8. Ability to create your custom content types definition to be used as a combination of interface and portal type, presented in a single widget.
  9. Export of search result in RSS.
  10. Pleasant user interface based on Ajax JQuery, implemented with “deep linking”, so bookmarking a faceted query works, browser history supported.
  11. Export / Import of faceted settings as XML. Useful to replicate same facets navigation on another site.
  12. Search engine friendly, disabling javascript acts as a normal collection batch list.
  13. Synchronization of settings across multiple languages, I18N support.
  14. High performance by caching faceted catalog queries via distributed memory object caching system: memcached
  15. Smart facets hiding - hide facets criteria if there is only one page of results (This can be explicitly disabled/enabled from version 4.6. It is also disabled by default for new faceted navigable pages starting with version 5.2)
  16. Ability to transform faceted navigable items in search forms by putting them in the ‘search mode’ (starting with version 4.6)
  17. Ability to enable/disable Plone portlets left and right columns within faceted navigable contexts (starting with version 4.1. Both disabled by default for new faceted navigable pages starting with version 5.2)


Getting started

  • Go to your working space and add a Folder and within Actions menu click on Enable faceted navigation. See more on the dedicated youtube channel: EEA Web Systems Training

Faceted settings

(New in version 4.1)

Faceted settings is a menu that appears once you enable Faceted navigation within your context next to the Actions menu and it allows you to perform the following actions:

Enable/disable left portlets

This allows you to gain more space for faceted navigation pages by disabling Plone portlets left column.

Default: disabled (starting with version 5.2)

Enable/disable right portlets

This allows you to gain more space for faceted navigation pages by disabling Plone portlets right column.

Default: disabled (starting with version 5.2)

Enable/disable smart facets hiding

Hide facets criteria if there is only one page of results.

Default: disabled (starting with version 5.2)

Autocomplete widget

To include a specific select2 locale, French for instance, you can add a resource ++resource++select2/select2_locale_fr.js in portal_javascripts (Plone 4). It needs to be after the select2.min.js resource. (You need eea.jquery 8.7 minimum)

You can add a new autocomplete source by registering a IAutocompleteSuggest browser view, you can see an example in eea/facetednavigation/tests/ and eea/facetednavigation/tests/autocomplete.zcml


You can extend faceted navigation functionality by installing the following addons:

  • Customized vocabularies
    • Products.ATVocabularyManager
  • Multilingual/translation solution
    • Products.LinguaPlone
  • Syndication
    • Products.basesyndication
    • Products.fatsyndication
    • bda.feed
  • Cache (memcache)
    • plone.memoize
    • eea.cache
  • Relations
    • eea.relations
  • Faceted extensions
    • eea.faceted.tool
    • eea.faceted.inheritance
  • Faceted themes


To gain performance, you can disable diazo theme on faceted results ajax requests. Go to “configuration registry” on control panel, select the key “Disable diazo rules on ajax requests” and set it True. Be sure you do not actually need it.

Plone versions

It has been developed and tested for Plone 2, 3, 4 and 5. See buildouts section above.

Other resources


EEA - European Environment Agency (EU)