Skip to content

Hierarchical term formatter#

The Hierarchical term (hierarchical_term_formatter) formatter displays terms in a hierarchical format.

Note

This formatter is only available for entity reference fields with a target_type of taxonomy_term.

Settings#

Setting Label Description Default
hierarchy_display Terms to display Option to filter the output of terms to display based on their depth all
hierarchy_link Link each term Option to output each term as a link to their term page FALSE
hierarchy_reverse Reverse order Option to reverse the term order so children display first FALSE
hierarchy_wrap Wrap each term Optional HTML element to wrap each term in none
hierarchy_separator Separator Text or markup that separates each term in the hierarchy »

Style settings#

These additional style settings give you complete control over the HTML markup generated by each subfield. This is one of the most powerful features of the Custom Field module for theming.

By customizing the wrapper tags and classes, you can:

  • Create clean, semantic HTML that matches your theme’s design system
  • Target individual subfields precisely with CSS (using subfield name and type)
  • Reduce CSS specificity issues and override battles
  • Improve accessibility and SEO with proper semantic elements (<section>, <article>, <h3>, etc.)
  • Easily integrate with CSS frameworks like Tailwind, Bootstrap, or custom component libraries

Default behavior (when left empty) produces a <div> wrapper with intelligent, predictable classes based on the subfield name and type — giving you excellent theming hooks right out of the box.

Setting Label Description
field_wrapper_tag Field wrapper tag HTML element that wraps the entire field + label
field_wrapper_class Field wrapper class Optional additional classes (space separated)
field_tag Field tag HTML element that wraps only the field value
field_class Field classes Optional field value classes (space separated)
label_tag Label tag HTML element that wraps the label
label_class Label classes Optional label classes (space separated)

Field types#