Drupal is a registered trademark of Dries Buytaert

This module leverage Drupal 11.1 Icon API which allow to define icon packs as YAML-discovered to integrate seamlessly in Drupal development and site-building with Field API (with Link attributes), CKeditor5, Menu API, Media, a Web font extractor and a library.

After installing this module, check our repository of examples to include existing icon pack providers.

Drupal compatibility

The 1.0.x branch is for Drupal 10.3 to 11.0 and include a backport of Drupal core Icon API. This branch will not be maintained.

The 1.1.x branch is for Drupal 11.1+ and upgrade from previous version. This branch include empty backport and Iconify sub modules to be removed. Use Iconify Icons 2.0.x instead.

Integration with Drupal site building tools

Once discovered from the icon packs, the icons can be used:

as a Field, with specific widget and formatter, to store a picked icon and render it in entity displays. as a Field Formatter for Link fields. in Menu links UI. in Ckeditor5, to add an icon in WYSIWYG content. in Media, as a media type.

Feel free to propose other integrations.

Icons library

The UI Icons Library sub-module generates an icons library page to be used as documentation for content editors or as a showcase for business and clients.

Showcases

This module does not include third-party icons but makes it very simple to add existing icons from any provider or your own, and mix them together!

Examples in contrib space:

Bootstrap 5 DSFR (French Gov) USWDS (US Gov) 1 pack 3 packs 1 pack DaisyUI 4 packs folder

You can also check our examples repository which include a lot of starting configuration to include icons from:

Drupal core

We are willing to push part of this module to Drupal core, The Icon API was a first step, next step:

Feel free to contact me if you're willing to help.

Incompatibility

UI Suite

UI Suite provides a cohesive set of modules to implement full design systems while preserving and improving the Drupal site building experience.

UI Icons can be used as standalone, but shines with other UI Suite modules. Together, they provide a a full API to implement design systems:

Activity

Total releases
13
First release
Dec 2024
Latest release
2 weeks ago
Release cadence
36 days
Stability
31% stable

Release Timeline

Releases

Version Type Release date
1.1.1 Stable Feb 10, 2026
1.0.1 Stable Feb 10, 2026
1.0.0 Stable Jan 18, 2026
1.1.0 Stable Jan 18, 2026
1.1.0-beta6 Pre-release Jun 20, 2025
1.1.0-beta5 Pre-release Jun 18, 2025
1.1.0-beta4 Pre-release Feb 19, 2025
1.0.0-beta7 Pre-release Feb 19, 2025
1.1.0-beta3 Pre-release Jan 30, 2025
1.0.0-beta6 Pre-release Jan 29, 2025
1.0.0-beta5 Pre-release Jan 17, 2025
1.1.0-beta2 Pre-release Jan 17, 2025
1.0.0-beta3 Pre-release Dec 5, 2024