v2.1.0

🎨 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

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

Full Changelog: v2.0...v2.1.0

v2.0

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

v1.3.0

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

Full Changelog: v1.2.0...v1.3.0

v1.2.0

• add Statamic 5 support
• fix stack header styling issue

Full Changelog: v1.1.0...v1.2.0

v1.1.0

• Fix when using the fieldtype in a Global.

v1.0.0

• 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.

v0.1.0

• 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.

v0.0.1

First test release.