Guide
Replace Heroicons in Filament
Three ways to change FilamentPHP's icons, and the icon sets you can use on v4 and v5, compared.
Who wrote this
FilaFly makes the Filament Icons core package and 8 of the icon packs on this page. Packs from other authors are listed too, including the most installed Lucide pack, which isn't ours. Checked November 16, 2026.
What "replacing Heroicons" means
Filament draws its icons with Blade Icons and installs the Heroicons set by default. There are two kinds of icon in a panel:
- Filament's own icons: the sidebar, search, table actions, filters, notifications,
form fields and so on. Filament names each one with an alias, such as
PanelsIconAlias::GLOBAL_SEARCH_FIELD. - Your icons: the ones you set on navigation items, actions and columns with
->icon().
You can change either kind, or both. There are three ways.
Option 1: swap every icon with an icon-pack plugin
An icon-pack plugin maps every Filament alias to an icon from another set, so the whole UI changes at once. With a FilaFly pack, it's one Composer package and one line in your panel provider:
composer require filafly/filament-lucide-icons
use Filafly\Icons\Lucide\LucideIcons;
public function panel(Panel $panel): Panel
{
return $panel
->plugin(LucideIcons::make());
}
Packs with several styles let you switch style for the whole panel, or for single aliases. Each pack's own page has the details.
Option 2: change single icons with FilamentIcon::register()
To replace only a few icons, register them in the boot() method of a service provider, as
the Filament icons docs show. The key is the
alias, the value is any Blade icon name (or a view):
use Filament\Support\Facades\FilamentIcon;
use Filament\View\PanelsIconAlias;
FilamentIcon::register([
PanelsIconAlias::GLOBAL_SEARCH_FIELD => 'fas-magnifying-glass',
PanelsIconAlias::SIDEBAR_GROUP_COLLAPSE_BUTTON => view('icons.chevron-up'),
]);
The docs list every alias. This is the right tool for a handful of changes; for a whole set it means mapping each alias by hand, which is what the icon packs do for you.
Option 3: use any Blade Icons set for your own icons
If you only want different icons on your own navigation, actions and columns, install that set's Blade Icons package and pass its icon names:
Action::make('star')->icon('iconic-star');
Filament's own icons stay as Heroicons. The Blade Icons website lists every package and lets you search their icons.
Icon sets compared
Every pack below replaces all of Filament's own icons, and supports Filament v4 and v5. All but Font Awesome include an enum of the set's icons for IDE autocompletion. They all build on Filament Icons, FilaFly's free core package, which you can also use to build a pack for any other Blade Icons set.
| Set | Icons | Styles | Blade Icons package |
|---|---|---|---|
| Bootstrap Icons | 2,078 | Regular, Fill | davidhsianturi/blade-bootstrap-icons |
| Carbon (IBM) | 2,300+ | One style | codeat3/blade-carbon-icons |
| Font Awesome | Depends on Free or Pro | Classic Solid, Regular, Light, Thin; Duotone; Sharp (Pro styles need Font Awesome Pro) | owenvoke/blade-fontawesome |
| Hugeicons | 4,500+ | One style (stroke) | afatmustafa/blade-hugeicons |
| Iconoir | 1,600+ | Regular, Solid | andreiio/blade-iconoir |
| Lucide | 2,287 | One style (outline) | mallardduck/blade-lucide-icons |
| Phosphor | 1,500+ | Regular, Bold, Duotone, Fill, Light, Thin | codeat3/blade-phosphor-icons |
| Remix Icon | 3,229 | Line, Fill | andreiio/blade-remix-icon |
All FilaFly icon packs are free and MIT-licensed; the icon sets keep their own licences.
Packs from other authors
Not all of these replace Filament's own icons: some give you an enum for using a set in your own code (Option 3). Monthly installs are from Packagist.
| Package | What it does | Replaces Filament's icons? | Filament |
|---|---|---|---|
| codewithdennis/filament-lucide-icons | A Lucide enum for the icons you set yourself. The most installed Lucide option (about 16,000 a month). | No | v4, v5 |
| tonegabes/filament-phosphor-icons | A Phosphor enum, with weights, for the icons you set yourself (about 6,000 installs a month). | No | v4, v5 |
| daljo25/filament-tabler-icons | Replaces Filament's UI icons with Tabler automatically, with alias overrides and an enum. FilaFly doesn't have a Tabler pack yet. | Yes | v4, v5 |
| guava/filament-icons | Generates enum classes for any Blade Icons set you have installed. Useful with Option 3. | No | v4, v5 |
Two packs that register the same Blade prefix (two Lucide packs, say) conflict, so pick one per set.
Which set should you pick?
- Closest to Heroicons, but more icons: Lucide or Tabler (clean outline icons).
- Several weights from one set: Phosphor (six styles) or Font Awesome.
- You already pay for Font Awesome Pro: Font Awesome, to use the Pro styles.
- A filled look: Remix, Bootstrap or Iconoir, which have filled or solid styles.
- An enterprise, IBM-style UI: Carbon.
Troubleshooting
- Icons don't change after install: check the plugin is registered on the right panel,
then clear cached icons and views with
php artisan icons:clearandphp artisan view:clear(or re-runphp artisan icons:cacheif you cache them in production). - "Svg not found" errors: the icon name doesn't exist in that set or style. Check the name on the Blade Icons site, or use the pack's enum.
- Two packs fight over a prefix: remove one; a prefix can only be registered once.
Frequently asked questions
What icons does Filament use?
Heroicons. Filament installs the Heroicons set by default and every icon in its UI is a Heroicon unless you replace it. The Heroicon enum gives you autocompletion for them.
Can I use Font Awesome in Filament?
Yes. Install a Blade Icons package for Font Awesome (owenvoke/blade-fontawesome) to use its icons in your own resources, or an icon-pack plugin to replace every Heroicon in the UI with Font Awesome, including Pro styles if you have a Pro licence.
How do I change one icon in Filament?
Call FilamentIcon::register() in a service provider's boot() method with the icon alias as the key and the Blade icon name as the value, for example PanelsIconAlias::GLOBAL_SEARCH_FIELD => 'fas-magnifying-glass'.
Which Lucide package should I use for Filament?
It depends on what you want to change. For Lucide icons on your own navigation, actions and columns, codewithdennis/filament-lucide-icons (the most installed) gives you a Lucide enum. To also swap Filament's own icons, filafly/filament-lucide-icons maps every Filament 5 icon alias to Lucide and includes an enum too. Both register the lucide prefix, so install only one.
Do icon packs work on Filament v3?
The packs listed here require Filament v4 or v5. On v3, check each pack's release history for an older version that supports it, or register icons yourself with FilamentIcon::register().
Filament icon packs by FilaFly
- Bootstrap Icons Free Replace every icon in your Filament panel with Bootstrap Icons, in regular or fill style, including the rich editor toolbar and multi-factor auth. All 2,078 icons as an enum, one line of setup.
- Carbon Icons Free A Carbon icon set implementation for Filament v4 and v5, providing the full set of Carbon icons integrated with Filament's interface.
- Font Awesome Icons Free Tired of Heroicons? Quickly swap out all icons used by the Filament framework with Font Awesome icons.
- Hugeicons Icons Free Replace every icon in your Filament panel with Hugeicons, the clean line icons Citrus ships with. Over 4,500 icons, one line of setup.
- Iconoir Icons Free Transform your Filament interface with the elegant and modern Iconoir icon set, a perfect replacement for the default icons.
- Lucide Icons Free Replace every icon in your Filament panel with Lucide, including the rich editor toolbar and multi-factor auth. All 2,287 Lucide icons as an enum, one line of setup.
- Phosphor Icons Free Looking to refresh your icons? Easily replace Filament's default icons with the Phosphor icon set.
- Remix Icons Free Replace every icon in your Filament panel with Remix Icon, in line or fill style, including the rich editor toolbar and multi-factor auth. All 3,229 icons as an enum, one line of setup.