Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Config entity icon

No security coverage Under active development 1 sites

This module adds an icon picker to configuration entity forms, allowing you to select and store an icon for entity types like content types and taxonomies. It works with various icon packs and stores the chosen icon as a setting with the entity, eliminating the need for separate modules for each entity type.

Adds an icon picker to the edit form of any Drupal config entity — node types, taxonomy vocabularies, menus, media types, custom config entities — and stores the chosen icon as a third-party setting on the entity itself.

Built on top of Drupal core's Icon API (11.1+) via the contributed UI Icons module, so any registered icon pack works out of the box: Lucide, Bootstrap Icons, Font Awesome, Iconify, custom SVG packs — pick from whichever you've installed.

Replaces the need for per-entity-type icon modules (node_type_icon, taxonomy_term_icon, …) with a single, generic mechanism that works for every existing config entity type and every future one without code changes.

Features

  • Any config entity — admin picks which entity types get the picker via a settings page
  • Any icon pack — works with all Icon API providers (Lucide, Bootstrap Icons, Font Awesome, custom packs)
  • Third-party setting storage — no schema changes, no new fields, icon travels with the entity's config
  • Lightweight resolver service — config_entity_icon.resolver for reading + rendering icons from PHP
  • Auto-placement in existing forms — integrates with the additional_settings vertical tab when present
  • Fully OOP — modern PHP 8.3+, no procedural hooks, attribute-based registration

Requirements

Usage

After installation:

  1. Visit Administration » Configuration » User interface » Config Entity Icon
  2. Tick the entity types you want to receive an icon picker (e.g. Content type, Taxonomy vocabulary, Menu)
  3. Edit any entity of an enabled type — an Icon picker appears on the form
  4. Render the chosen icon in any template or PHP via the config_entity_icon.resolver service

Other icon-related modules

License

  • Module: GPL-2.0-or-later

For installation, usage, and technical details see README.md.

Drupal 11 · not 10 PHP >=8.3

Ask your assistant about Config entity icon

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

  • file Drupal core
  • system Drupal core

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
3
Tracked since
May 2026
Latest release
2 weeks ago
Releases (12 mo)
3 ▲ from 0
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
0.0.4 Stable 11 PHP >=8.3 Nov 5, 2026
0.0.1 Stable 11 May 19, 2026
0.x-dev Dev 11 May 19, 2026