> For the complete documentation index, see [llms.txt](https://docs.inforiver.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.inforiver.com/super-filter/filter-types/3.-hierarchy-filter.md).

# 3. Hierarchy Filter

The **Hierarchy Filter View** enables users to display and interact with data in a hierarchical structure within the visual. This feature allows easier navigation and filtering of data, especially when dealing with multi-level categories.

{% embed url="<https://www.youtube.com/watch?index=14&list=PLisLVA_RnBO5QEJvAbyNHwfdboQVbF7LC&t=63s&v=wadnYIlFIyY>" %}
Video 1: Hierarchy Filter
{% endembed %}

## How to enable Hierarchy Filter:

{% stepper %}
{% step %}
Add the required data to the **Category** field in the visualizations pane.
{% endstep %}

{% step %}
Go to the **Format Visual** and enable the **Hierarchy Filter** toggle to "On."
{% endstep %}

{% step %}
By default, checkbox is shown to filter from the hierarchy.
{% endstep %}
{% endstepper %}

<figure><img src="/files/mc7rAagNRfy7W3JYY1dG" alt=""><figcaption><p>Image 1: Hierarchy Filter with Radio view type.</p></figcaption></figure>

## Configuring the Hierarchy View:

When Hierarchy Filter is enabled, additional sections for customization become available in the format pane:

### **General Section:**

#### **1. Category Styles:**&#x20;

* When enabled allows user to customize specific styling for different levels of the hierarchy.
* When **Category Styles** is enabled, node-specific sections like **Top Node Style**, **Parent Node Style**, and **Child Node Style** are disabled.

#### **2. View Type:**

* Choose from **Checkbox**, **Radio**, or **List** options for selecting items. By default, checkbox is multi select and radio is single select. When the list option is selected, a toggle is provided to enable or disable single select.

<div><figure><img src="/files/mFobsubnB6R4XolF7D0d" alt=""><figcaption><p>Image 2: Radio View Type</p></figcaption></figure> <figure><img src="/files/game3Km0Gca7qVpKVUYF" alt=""><figcaption><p>Image 3: List View Type</p></figcaption></figure> <figure><img src="/files/GbpBPAzKxW5x1iAJPFDA" alt=""><figcaption><p>Image 4: Checkbox View Type</p></figcaption></figure></div>

#### **3. Leaf Single Select:**

* Allows user to customize the default behavior for single selection in hierarchical filters. By default, selecting a parent node selects all its children—even in single select mode.&#x20;
* When this option is enabled, selecting a parent will instead select only the **first child**, providing more precise control. This setting is available for both **Radio** and **List** view types.

#### **4. Default Expand to Level:**

* Configure the "Expand to Level" setting to define the number of hierarchy levels to be expanded in the visual.

#### **5. Parent Child Indent:**

* Use this option to set the indentation level for parent-child hierarchies by specifying the desired indentation value.

<figure><img src="/files/8Ffp7KHUOmtHhWgtsjlv" alt="" width="263"><figcaption><p>Image 5: Expand to level and Parent child indent options</p></figcaption></figure>

#### **6. Custom Context Menu**:

* Enable to activate additional options, such as Expand All, Collapse All, and Expand To, accessible via right-click in the visual.

<figure><img src="/files/INuz67juPRu8bYziRD0y" alt="" width="280"><figcaption><p>Image 6: Custom Context menu in Hierarchy Filter</p></figcaption></figure>

#### **7. Display Child Count**:

* When enabled, you can select the **Child  Count Type** as **Leaf Count** or **Immediate Child**.
* **Leaf Count**: Shows the total number of child elements at the leaf level.
* **Immediate Child**: Displays the count of direct child elements.

<figure><img src="/files/xxelW89I7AKPU2eGC8hR" alt=""><figcaption><p>Image 7: Child count type selection in format pane</p></figcaption></figure>

#### **8. Single Child Display**:

* When enabled, you can select the display as Display All (XABCN), Display Parent Only (XABC), Display Parent (Multi-Level) (XA), Display Child as Parent (XAN).
* **Display All (XABCN)**: Shows all levels.
* **Display Parent Only (XABC)**: Displays only the parent level.
* **Display Parent (Multi-Level) (XA)**: Displays all parent levels.
* **Display Child as Parent (XAN)**: Shows the last level as the parent.

### **Appearance Section:**

<figure><img src="/files/c0K2koCK5NEB1dtKpOyy" alt="" width="311"><figcaption><p>Image 8: Appearance Section in format pane</p></figcaption></figure>

#### **1. Alternate Row Customization**:

* Enable it to apply alternating background colors for rows.
* Customize the background color via a color selection pop-up.

<figure><img src="/files/HbVdv7rZ0BI4PsPOrWVc" alt="" width="289"><figcaption><p>Image 9: Alternate Row customisation with options to choose color</p></figcaption></figure>

#### **2. Expand Collapse Icon:**

* Select Arrow or Plus/Minus as the expand collapse icon from the dropdown list.

<div><figure><img src="/files/79p0l4VE14LdU9R3aGcn" alt="" width="220"><figcaption><p>Image 10: Plus/Minus icon for expand collapse</p></figcaption></figure> <figure><img src="/files/pCmxzEFA0VV8zTYMiG8w" alt="" width="219"><figcaption><p>Image 11: Arrow Icon for expand collapse</p></figcaption></figure></div>

#### **3. Utility Icons:**

* Enable this option to display utility icons like Copy and Expand/Collapse within the visual on Hover.

<figure><img src="/files/5dBC1UvoNWMyWuq1x1oo" alt="" width="330"><figcaption><p>Image 12: Utility icons when enabled in the visual</p></figcaption></figure>

### Note Styles Section:

<figure><img src="/files/srkwWt4IFUSMZPP939l7" alt="" width="168"><figcaption><p>Image 13: Node styles section in Format pane</p></figcaption></figure>

1. **Top Node Style**:
   * Enabled when there are three or more levels in the **Category Field**.
   * Customize **Font Style** as Bold, Italics, or Defaul&#x74;**, Font Size** and **Font Color.**
2. **Parent Node Style**:
   * Enabled when there are two or more levels in the **Category Field**.
   * Customize **Font Style** as Bold, Italics, or Defaul&#x74;**, Font Size** and **Font Color.**
3. **Child Node Style**:
   * Enabled when there is only one level in the **Category Field**.
   * Customize **Font Style** as Bold, Italics, or Defaul&#x74;**, Font Size** and **Font Color.**

<figure><img src="/files/6RDtUCpwpFAEq2Zm4rwK" alt="" width="299"><figcaption><p>Image 2: Hierarchy Filter with Top, Parent and Child node style configurations.</p></figcaption></figure>

### Category Styles Section:

Enable Category Styles in hierarchy filter options to format the category using Category styles as in facet filter.

1. **General Section:** Configuring this Applies to all levels in the category field. Configuration options available in this section are the following:
   * **Text Color**: Click on the Dropdown to select a color.
   * **Background Color**: Click on the Dropdown to select a color.
   * **Font Style**: Dropdown to set font style, with size adjustment and formatting options (**Bold**, **Italics**, **Underline**).
   * **Header Label Color**: Click on the Dropdown to select a color.
   * **Header Background Color**: Click on the Dropdown to select a color.
   * **Header Font Style**: Dropdown to set font style, with size adjustment and formatting options (**Bold**, **Italics**, **Underline**).
2. **Category Section:** Sections are added corresponding to the data entered in the category field. Configuration options available in this section are the following:
   * **Filter Type**: Dropdown to choose filter icons (Checkbox, Radio, List, Dropdown, Tile, Toggle).
   * **Single Select**: Toggle to enable or disable single selection (available for List, Dropdown, Tile, and Toggle filter types).
   * **Placeholder Text**: Option to set placeholder text.
   * **Text Color**: Dropdown with a pop-up to choose a color.
   * **Background Color**: Dropdown with a pop-up to choose a color.
   * **Font Style**: Dropdown to set font style, with size adjustment and formatting options (**Bold**, **Italics**, **Underline**).
   * **Header Text Color**: Dropdown to select a color for header text.
   * **Header Background Color**: Dropdown to select a background color for the header.
   * **Header Font Style**: Dropdown for font customization, with size adjustment and formatting options as described above.
3. **Reset to Default**: A button located at the bottom left of the **Category Styles** section to reset all customizations.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.inforiver.com/super-filter/filter-types/3.-hierarchy-filter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.