Iconify Icon

Iconify

2.1.0

March 9th, 2026

🎨 Icon Set Filtering & Configuration

This release adds powerful filtering capabilities to control which icons are available to your content editors.

Highlights

Global config file β€” Publish config/statamic-iconify.php to lock down allowed icon sets, categories, and licenses site-wide.

php artisan vendor:publish --tag=statamic-iconify-config

Field-level filtering β€” Each Iconify field in your blueprints gets three new config dropdowns:

  • Icon Sets β€” multi-select, populated from the Iconify API
  • Category β€” single select (General, UI 24px, Emoji, Thematic, etc.)
  • Licenses β€” multi-select (MIT, Apache 2.0, CC BY 4.0, etc.)

Field config can only narrow within what the global config allows β€” never widen.

Dark mode fixes β€” Grid hover labels now use Statamic UI Badge components for proper light/dark theming.

What's new

  • Publishable config with allowed_prefixes, allowed_categories, allowed_licenses, and default_store_as
  • Field-level icon set, category, and license filtering via native Statamic select dropdowns
  • Dropdowns auto-populated from the Iconify /collections API (cached 24h)
  • Color-coded filter badges in the search modal (purple for sets, blue for category, green for licenses)
  • Grouped badge display with tooltip for long lists (e.g. "Sets: mdi, tabler +3 more")
  • Pest (PHP) and Vitest (JS) test suites
  • CP endpoint GET /iconify/config for frontend config access

Fixes

  • Icon tag no longer crashes when field value is a plain string
  • Grid card hover labels clip properly to rounded corners

Example config

#676E95;">// config/statamic-iconify.php
#89DDFF;">return #89DDFF;">[
#89DDFF;">'allowed_prefixes#89DDFF;">' #89DDFF;">=> #89DDFF;">[#89DDFF;">'mdi#89DDFF;">'#89DDFF;">, #89DDFF;">'tabler#89DDFF;">'#89DDFF;">, #89DDFF;">'heroicons#89DDFF;">'#89DDFF;">, #89DDFF;">'ph#89DDFF;">'#89DDFF;">],
#89DDFF;">'allowed_categories#89DDFF;">' #89DDFF;">=> #89DDFF;">[],
#89DDFF;">'allowed_licenses#89DDFF;">' #89DDFF;">=> #89DDFF;">[#89DDFF;">'MIT#89DDFF;">'#89DDFF;">, #89DDFF;">'Apache 2.0#89DDFF;">'#89DDFF;">],
#89DDFF;">'default_store_as#89DDFF;">' #89DDFF;">=> #89DDFF;">'name#89DDFF;">'#89DDFF;">,
#89DDFF;">];

Full Changelog: https://github.com/eminos/statamic-iconify/compare/v2.0...v2.1.0

2.0

January 19th, 2026

  • Statamic 6 support with a complete Vue 3 rewrite of the component.
  • Removed the ky dependency

1.3.0

May 27th, 2024

  • fix deprecated array_get() method (Statamic 5)
  • add support for Statamic 5.3 dark mode

Full Changelog: https://github.com/eminos/statamic-iconify/compare/v1.2.0...v1.3.0

1.2.0

May 9th, 2024

  • add Statamic 5 support
  • fix stack header styling issue

Full Changelog: https://github.com/eminos/statamic-iconify/compare/v1.1.0...v1.2.0

1.1.0

May 2nd, 2024

  • Fix when using the fieldtype in a Global.

1.0.0

October 2nd, 2023

  • Fixed bug when removing the icon.
  • Changed the button to say "Browse Iconify" and made it regular sized to better match default Statamic UI.
  • This is considered stable now so I'm bumping it up to v1.0.0.

0.1.0

September 18th, 2023

  • Added the possibility to choose how to store the icon. As "icon name only" or "SVG data".
  • Added an Antlers Tag to render the SVG.
  • Improved the search GUI.

0.0.1

September 15th, 2023

First test release.