Filament Icon Picker Laravel Package

5.0.0 (2026-08-04)

⚠ BREAKING CHANGES

• fuse.js is replaced by @leeoniya/ufuzzy.
• getSetJs(), getIconsJs() and getIconSvgJs() are removed; the package now registers two routes under the _icon-picker prefix.
• getIcon() now returns null for ids with no file, and icon labels drop the set prefix ("O academic cap", not "Heroicon o academic cap").
• CanBeCacheable is removed and cache config moved from icon-picker.cache.* to filament-icon-picker.cache.*.

Features

• cache icon listings server-side and rename the config namespace (233c742)
• sanitize uploaded svg icons and restrict icon labels (dff53e0)
• serve icons over token-authorized endpoints instead of Livewire (4beaf26)
• swap fuse.js for uFuzzy and batch svg fetching on the client (953904c)

Bug Fixes

• check that custom icons exist instead of matching the set prefix (3269661)
• correct PSR-4 violation in CanBeCacheable and tighten icon manager types (76a9dd9)
• enforce scope and allowed sets when resolving icons (e8c4e51)
• use one source of truth for the custom icon set id (bc4be45)

Performance

• resolve single icons by file lookup instead of listing the set (4904607)

Refactor

• centralize custom icon scope ids in IconScope (e8d8e44)

4.0.0 (2026-01-24)

⚠ BREAKING CHANGES

• add support for filament v5

Features

• add support for filament v5 (5a8eb99)

Chore

• deps: bump dependabot/fetch-metadata from 2.4.0 to 2.5.0 (9afa3db)

3.1.0 (2025-08-23)

Features

• icons: improve icon fetching logic in IconManager (9b8efd2)

Chore

• deps: bump aglipanci/laravel-pint-action from 2.5 to 2.6 (c3f5181)

3.0.0 (2025-08-20)

⚠ BREAKING CHANGES

• filament v4 support

Features

• add the possibility to limit sets that should be shown (06f335f)
• added support for placeholders in icon column (5b87e53)
• filament v4 support (2863a29)
• minor changes (a824e49)
• minor fixes and changes (988c029)
• prepare for release (f3633dc)
• remove display name when icon removed (6ffe4b0)
• scopes (b25569c)
• scopes (0e43a10)
• scopes (636eb8d)
• translations (67d4bdc)
• upload icons update JS after upload (bc68e1e)
• validation (acdc80d)
• validation (c32bd61)
• version 1 wip (b585a89)
• version 1 wip (35dbc0b)

Bug Fixes

• icon column null if icon does not exist anymore (5489f2d)
• namespace (05e6e6d)

Refactor

• cleanup Icon (ffd261e)
• cleanup Icon (01f67d1)
• no results found and searching cards to own component (edd8b87)

Chore

• package setup (dfa90a5)
• package setup (72f0770)
• package setup (a28672c)
• update readme with installation information (f6bd724)

Style

• fix code styling (a55c3cb)

3.0.0-beta.1 (2025-08-19)

⚠ BREAKING CHANGES

• filament v4 support

Features

• added support for placeholders in icon column (5b87e53)
• filament v4 support (2863a29)
• minor changes (a824e49)
• minor fixes and changes (988c029)
• prepare for release (f3633dc)
• remove display name when icon removed (6ffe4b0)
• scopes (b25569c)
• scopes (0e43a10)
• scopes (636eb8d)
• translations (67d4bdc)
• upload icons update JS after upload (bc68e1e)
• validation (acdc80d)
• validation (c32bd61)
• version 1 wip (b585a89)
• version 1 wip (35dbc0b)

Bug Fixes

• icon column null if icon does not exist anymore (5489f2d)

Refactor

• cleanup Icon (ffd261e)
• cleanup Icon (01f67d1)
• no results found and searching cards to own component (edd8b87)

Chore

• package setup (dfa90a5)
• package setup (72f0770)
• package setup (a28672c)

2.3.1 (2025-08-19)

2.3.0 (2025-02-25)

Features

• remove laravel dependency to support all versions (123543b)

2.2.4 (2024-06-27)

Features

• add preload support (dbd3ddd)

Bug Fixes

• README.md (ed309fe)

2.2.3 (2024-06-27)

Features

• Add caching for generating the icons array (63015bf)

2.2.2 (2024-05-22)

Bug Fixes

• support nested directories (22220c4)

2.2.1 (2024-05-11)

Bug Fixes

• parameters of createOptionUsing method (e2aa51c)

2.2.0 (2024-03-01)

Features

• add laravel 11 support (a5531db)

2.1.0 (2024-02-16)

Features

• automatically refresh cache on sets / icons change (db899b4)

2.0.4 (2024-01-27)

Bug Fixes

• icon column for nullable icons (e2b6cd1)

2.0.3 (2023-12-21)

Bug Fixes

• relationship signature (3c97ef5)

2.0.2 (2023-09-05)

Bug Fixes

• bump filament dependency to stable version (2953a4e)

2.0.1 (2023-07-21)

2.0.0 (2023-07-21)

⚠ BREAKING CHANGES

• Support for filament v3 added (dropped support for v2)

Features

• changes to support filament v3 (777cdd4)

1.3.6 (2023-02-18)

Bug Fixes

• upgrade deps to match Laravel 10 compatibility (9241cd5)

1.3.5 (2022-11-17)

Bug Fixes

• update readme (c040a72)

1.3.4 (2022-10-13)

Bug Fixes

• layout on_top wouldn't render correctly (c7b3cd9)

1.3.3 (2022-10-12)

Bug Fixes

• Method mismatch causing exception thrown on empty search query (5667fd6)

1.3.2 (2022-10-12)

Bug Fixes

• Method mismatch causing exception thrown on empty search query (4793fd0)

1.3.1 (2022-10-12)

1.3.0 (2022-10-12)

Features

• caching search results (babbe3b)

Bug Fixes

• Removed enums to support PHP 8.0 (4a8bf11)

1.2.1 (2022-10-12)

Bug Fixes

• fixed mismatched method signature (8cd76ce)

1.2.0 (2022-10-08)

Features

• Added configuration file for global defaults (4a9bd1b)

1.1.0 (2022-10-08)

Features

• Added icon column (275a7ea)

Bug Fixes

• Disabled multiple() method (ec332a8)

1.0.1 (2022-10-07)