Skip to content

Icon Library Admin UI

When to Use

Browsing every available icon during theme development, debugging discovery, or showing a stakeholder which packs the site has.

Pattern

Enable ui_icons_library. Visit /admin/appearance/ui/icons; a single pack is at /admin/appearance/ui/icons/{pack_id}. Both need the access ui icons library permission.

The page lists every registered pack (label, version, license, source links), and per pack shows a grid of all icons with live previews. Click any icon for detail: full ID, available settings, the rendered template output.

A search bar fuzzy-matches icon IDs across all packs.

Common Mistakes

  • Wrong: expecting icon counts to update without clearing cache → Right: run drush cr after adding icons; YamlDiscovery caches the pack contents

See Also