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, anddefault_store_as - Field-level icon set, category, and license filtering via native Statamic select dropdowns
- Dropdowns auto-populated from the Iconify
/collectionsAPI (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/configfor 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
kydependency
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.