Hierarchical Select

This is the documentation page for Hierarchical Select, a module that allows users to connect content to particular places in tree hierarchies. These content hierarchies can be made through Taxonomy, Entity Reference, Organic Groups with subgroups, and more.

There is a great demo available so you can try its user interface.

User documentation

D6:
Check out the readme file, it walks you through the entire proces.

D7:
After downloading and enabling the module there are a few places where you may want to set up its functionality:

  • A general configuration page appears in the configuration section. There you can, for example, change interface behaviour. It can be found at admin/config/content/hierarchical_select/configs
  • If you haven't done so already, it's handy to create the taxonomy vocabulary of the entity type you want to reference, so that you can later select it when creating your field.
  • Add a field that can use the widget to your content type, such as entity- or term reference fields, and select Hierarchical Select as the widget. The widget-settings can later be changed at the settings page of the field you just added.

There is a more detailed setup page in this documentation (look in the long list to the right, or the short list below).

API documentation

More details about the Hierarchical Select API can be found at the code repository.

HS API tutorial

How to Use Hierarchical Select for Something Other than Taxonomy

Hierarchical Select 4 Roadmap

This book page contains an overview of all desired functionality for the first major rewrite of Hierarchical Select, which will be version 4

Hierarchical Select in a block as a taxonomy filter

I've created a sample module that creates a new block which allows you to filter by Taxonomy term. The code is very clearly documented, to

Hierarchical Select setup

How to pre-populate the dropbox

In some cases, you'll want to pre-populate the dropbox. The answer is very simple. Use #default_value.

Guide maintainers

wim leers's picture