About Features Downloads Getting Started Documentation Events Support GitHub

Love VuFind®? Consider becoming a financial supporter. Your support helps build a better VuFind®!

Site Tools

Warning: This page has not been updated in over over a year and may be outdated or deprecated.


One of VuFind's most prominent features is faceted search, which allows a result set to be narrowed down based on values displayed in a sidebar.


  • VuFind allows for “configuration” of facets in terms of which facets to show and in which order. Just edit facets.ini in your favorite text editor to adjust Solr faceting. If you are not using Solr, most third-party content providers also allow faceting, which can be configured in the appropriate .ini file (e.g. Summon.ini, etc.).
  • One helpful way to understand facets is to submit queries to Solr to return faceted results directly in XML: See http://wiki.apache.org/solr/SimpleFacetParameters and scroll all the way down for examples of URLs. You can also turn on debug mode in config.ini to see exactly which URLs VuFind is generating for its own queries.
  • More details on adding facets (with a particular focus on building them using data in MARC records) can be found on this page.

Hierarchical Facets

VuFind supports hierarchical facets with Solr. The facet values need to be indexed as described in the Solr wiki with each value always ending in a trailing slash. Hierarchical facets are defined in facets.ini (see the SpecialFacets section) and there are also settings that define how they are sorted and displayed.

Below is an example of how a building facet could be indexed when the record belongs to a couple of different libraries:


Below is an example of format could be indexed for a record that contains physical copies as well as an online version:


Some of the topics from this page are also covered in the Configuring Search and Facet Settings video.

configuration/facets.txt · Last modified: 2021/08/03 13:57 by demiankatz