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:clear and php artisan view:clear (or re-run php artisan icons:cache if 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().