Skip to main content
Drupal is a registered trademark of Dries Buytaert
Release: OpenID Connect / OAuth client 3.0.0-alpha9 New alpha version released for module openid_connect (3.0.0-alpha9). Release: Timelinr 1.0.1 Minor update available for module timelinr (1.0.1). Usage Milestone: Simplify Module simplify crossed 10,000 active installs. Usage Milestone: Views Reference Filter Module entityreference_filter crossed 10,000 active installs. Usage Milestone: Dropdown Language Module dropdown_language crossed 10,000 active installs. Usage Milestone: Paragraphs Browser Module paragraphs_browser crossed 10,000 active installs. Usage Milestone: OpenAPI Module openapi crossed 10,000 active installs. Usage Milestone: Decoupled Router Module decoupled_router crossed 10,000 active installs. Usage Milestone: Time Field for Drupal 8+ Module time_field crossed 10,000 active installs. Module Revived: Entityqueue Buttons 1.1.2 Module entityqueue_buttons updated after 8 months of inactivity (1.1.2).

Hierarchical Select Ajax

2 sites No security coverage Drupal 9–11
View on drupal.org

This module provides an improved way to select taxonomy terms for fields, especially when you have many levels. It uses AJAX to load terms only as you select them, making it faster and easier to navigate deep hierarchies. You can also customize labels and settings for each level of the selection process.

The Hierarchical Select Ajax module provides a dynamic, AJAX-powered field widget and formatter for taxonomy term reference fields. It is designed to enhance the user experience when dealing with deep or complex taxonomy structures by loading child terms only when needed.

Key Features

  • AJAX-Powered Widget: Choose terms level-by-level using standard select elements that update dynamically via AJAX.
  • Customizable Depth: Limit the hierarchy depth to a specific level or allow full traversal.
  • Per-Level Customization:
    • Labels: Define unique labels for each level of the hierarchy (e.g., "Country", "State", "City").
    • Descriptions: Add specific help text for each level.
    • "No Selection" Labels: Customize the empty option text per level (e.g., "- Select a Country -", "- Select a State -").
  • Deepest Selection Support: Options to manage how values are saved based on the nesting level.
  • SHS-Style Formatter: Includes a Simple Hierarchical Select (SHS) style formatter for consistent display of the term hierarchy on the frontend.
  • Developer Friendly:
    • Exposes hooks (hook_hierarchical_select_ajax_element_alter and hook_hierarchical_select_ajax_settings_alter) to programmatically customize the element behavior and settings.
    • Clean, trait-based implementation for easy extension.
  • Lightweight & Fast: Only loads the terms required for the current selection context, minimizing initial page load.

Installation & Configuration

  1. Enable the module as usual.
  2. Go to the "Manage Form Display" tab of your entity (e.g., Content Type, Media Type).
  3. Select Hierarchical select ajax as the widget for your taxonomy term reference field.
  4. Click the cog icon to configure the hierarchy depth and per-level labels.
  5. (Optional) Go to the "Manage Display" tab and select Hierarchical select ajax SHS as the formatter to display the hierarchy.

Requirements

  • Drupal 9, 10, or 11.
  • Core Taxonomy module.

Similar Modules

While similar to modules like Simple Hierarchical Select (SHS) or Client-side Hierarchical Select, this module focuses on a robust backend AJAX implementation with granular per-level configuration and developer-centric extensibility.

Depends on

Dependencies of the latest stable release

  • field Drupal core
  • taxonomy Drupal core

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
2
Tracked since
Dec 2025
Latest release
5 months ago
Releases (12 mo)
2 ▲ from 0
Maintenance
Active

Releases

Version Type Core Release date
1.0.2 Stable 9–11 Mar 24, 2026
1.0.1 Stable 9–11 Dec 30, 2025