This module allows content editors to separate a heading's semantic meaning from its visual appearance, preventing improper tag use for SEO and accessibility. It also enables headings to function as links and supports custom styling, storing all data efficiently in a single table.
Advanced Header Field provides a heading field that separates semantic meaning from visual style. Content editors can choose an appropriate heading level for accessibility and SEO without being limited by its visual presentation.
The field extends Drupal’s Link field, so headings can link to a destination. It also supports optional subtitles, generated or custom anchor IDs, built-in display styles, and project-specific styles. Heading data is stored together in the field’s storage table.
Features
- Choose a semantic heading tag independently from its visual size.
- Add an optional subtitle or link the heading.
- Generate an anchor ID or set a custom one.
- Apply built-in styles or configure project-specific styles.
- Choose the HTML Markup or Summary formatter.
- Optionally add a jump-menu block with the Advanced Header Field Navigation submodule.
Common use case
Add the field to layout Paragraphs to give each page section a meaningful heading and anchor. Editors can choose a heading level that fits the page structure while styling it to match the layout. With the optional Navigation submodule, selected section headings can also populate a jump menu.
Usage
Install the module with Composer and enable it along with Drupal core’s Link module:
composer require drupal/advanced_header_field
drush en link advanced_header_fieldAdd an Advanced Header Field to an entity bundle, configure the allowed heading tags and any custom styles, then select the HTML Markup formatter in the entity’s display settings. Styling is provided by your theme.
The optional Navigation submodule adds jump-menu controls to the field widget and provides the Advanced Header Field Jump Menu block. For headings to appear in the menu, configure the HTML Markup formatter to use its Semantic (<header>) wrapper.
Ask your assistant about Advanced Header Field
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
No dependencies recorded for this project.
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.
Activity
Release Timeline
Releases
| Version | Type | Core | PHP | Release date | |
|---|---|---|---|---|---|
| 3.1.0 | Stable | 11 | Oct 9, 2026 | ||
| 3.0.2 | Stable | 11 | Aug 11, 2026 | ||
| 3.0.1 | Stable | 11 | Mar 17, 2026 | ||
| 3.0.0 | Stable | 11 | Feb 27, 2026 | ||
| 2.1.1 | Stable | 10–11 | Nov 6, 2025 | ||
| 2.1.0 | Stable | 10–11 | Oct 3, 2025 | ||
| 2.0.2 | Stable | 10–11 | Sep 26, 2025 | ||
| 2.0.1 | Stable | 10–11 | Sep 26, 2025 | ||
| 2.0.0 | Stable | 9–11 | Sep 26, 2025 | ||
| 1.2.2 | Stable | 9–11 | Aug 21, 2025 |