Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Hierarchical Select Ajax

No security coverage Under active development 2 sites

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.

Drupal 9–11

Ask your assistant about Hierarchical Select Ajax

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

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
4
Tracked since
Apr 2024
Latest release
6 months ago
Releases (12 mo)
2 ▲ from 0
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
1.0.2 Stable 9–11 Mar 24, 2026
1.0.1 Stable 9–11 Dec 30, 2025
1.0.0 Stable 9–10 Apr 11, 2024
1.0.x-dev Dev 9–11 Apr 11, 2024