This module integrates with Drupal's Icon API to allow developers and site builders to easily use icons from various providers. Icons can be incorporated into fields, menus, CKeditor, and media types, with an added library page for showcasing available icons.
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 2.0.x branch is for Drupal 11.3+
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 folderYou can also check our examples repository which include a lot of starting configuration to include icons from:
- Bootstrap Icons
- Delta icons
- Evil icons
- Feather Icons
- FontAwesome (Free version)
- Heroicons
- Iconicons
- Lineicons
- Lucid
- Maki
- Material Symbols
- Octicons
- Phosphor Icons
- Remix icon
- Iconoir
- Flowbite icons
- Tabler icons (Free version)
- Boxicons (v2)
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 Icons CKeditor5 is not compatible with ckeditor5_icons module
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:
Depends on
Dependencies of the latest stable release
No dependencies recorded for this project.
Required by
6 tracked projects depend on this one
- Ui Suite Dsfr 95 sites
- UI Suite USWDS 44 sites
- Icon media pack 8 sites
- Config entity icon 2 sites
- OGCB Base theme (built on kern_ux) 2 sites
- Calimals
Activity
Release Timeline
Releases
| Version | Type | Core | Notes | Release date | |
|---|---|---|---|---|---|
| 2.0.0 | Stable | 11 | UI Icons 2.0.0 targets Drupal 11.3 and 12 only, adds Drupal Canvas integration and CKEditor 5 icon editing, and drops the 1.0.x backport modules, UI Patterns 1.x support and all procedural hooks. | Aug 3, 2026 | |
| 2.0.x-dev | Dev | 11 | UI Icons 2.0.0 targets Drupal 11.3 and 12 only, adds Drupal Canvas integration and CKEditor 5 icon editing, and drops the 1.0.x backport modules, UI Patterns 1.x support, and all procedural hooks. | Aug 3, 2026 | |
| 1.1.2 | Stable | 11 | Minor fixes and updates | Apr 16, 2026 | |
| 1.1.1 | Stable | 11 | Feb 10, 2026 | ||
| 1.0.1 | Stable | 10–11 | Feb 10, 2026 | ||
| 1.0.0 | Stable | 10–11 | Stable release of UI Icons for Drupal 10! | Jan 18, 2026 | |
| 1.1.0 | Stable | 11 | Stable release of UI Icons! | Jan 18, 2026 | |
| 1.1.0-beta6 | Pre-release | 11 | Fix layout builder integration | Jun 20, 2025 | |
| 1.1.0-beta5 | Pre-release | 11 | Bug fixes, update element design and themes compatibility, new autocomplete grid | Jun 18, 2025 | |
| 1.1.0-beta4 | Pre-release | 11 | Feb 19, 2025 | ||
| 1.0.0-beta7 | Pre-release | 10–11 | Bug fixes | Feb 19, 2025 | |
| 1.1.0-beta3 | Pre-release | 11 | Fix composer dependency | Jan 30, 2025 | |
| 1.0.0-beta6 | Pre-release | 10–11 | Add proper composer.json dependencies. | Jan 29, 2025 | |
| 1.0.0-beta5 | Pre-release | 10–11 | Minor fixes backported from 1.1.x | Jan 17, 2025 | |
| 1.1.0-beta2 | Pre-release | 11 | Minor fixes | Jan 17, 2025 | |
| 1.1.0-beta1 | Pre-release | 11 | Drupal 11.1+ compatibility initial release, bug fix. | Jan 9, 2025 | |
| 1.0.0-beta4 | Pre-release | 10–11 | Drupal < 11.1 compatibility and bug fix | Jan 9, 2025 | |
| 1.1.x-dev | Dev | 10–11 | Initial release for Drupal 11.1+ with Icon API. | Jan 9, 2025 | |
| 1.0.0-beta3 | Pre-release | 10–11 | Some breaking changes, separated API, improvments and new implementations | Dec 5, 2024 | |
| 1.0.0-beta2 | Pre-release | 10–11 | New definition name icons.yml, refactoring and some fixes | Oct 17, 2024 | |
| 1.0.0-beta1 | Pre-release | 10–11 | New feat, lot of bugfix and qa | Sep 25, 2024 |