Font Awesome Icons plugin screenshot
Dark mode ready
No multilingual support
No v5.x support

Font Awesome Icons by Filafly

Community

Quickly swap out all icons used by the Filament framework with Font Awesome icons.

Tags: Panels Icon Set
Supported versions:
3.x
Filafly avatar Author: Filafly

Package health

Automated checks of this plugin's Composer package

96 / 100
Security 100
Maintenance 100
Ecosystem 76
15 checks
  • Skipped: GitHub Actions pinned to SHA
  • Skipped: GitLab CI includes pinned to SHA
  • Passed: Open security advisories
  • Passed: Dependabot PR responsiveness — No open Dependabot PRs.
  • Skipped: Renovate MR responsiveness
  • Passed: Dependabot or Renovate configured
  • Passed: Dependency update cooldown configured
  • Passed: Provides a security policy
  • Passed: Abandoned or archived — No consulted source marks the package abandoned (packagist, github).
  • Passed: Commit and release recency — Active: last commit 1 days ago; last release 257 days ago.
  • Passed: composer.lock not committed by library — composer.lock is absent from the released dist archive.
  • Passed: Dist archive is lean
  • Warning: Current Laravel version supported — Package does not co-install with current Laravel 13.0; the newest co-installable line is 12.0, which receives security patches only (until 2027-02-24).
  • Passed: Current PHP version supported — Constraint ^8.2 supports current PHP 8.5.
  • Skipped: Current Symfony version supported
Third-party plugin. This is built by the community, not the Filament team. Filament does not review, endorse, or vet the security of plugins outside the filament/ namespace. Review the source and install at your own risk. Found malware or an unresolved security issue the author won't address? Report it .
Powered by Plumb Last scanned 1 week ago

Documentation

Banner

A Font Awesome icon set implementation for Filament Icons, providing a comprehensive set of Font Awesome icons that seamlessly integrate with Filament's interface.

This package extends the base Filament Icons package to replace Filament's default Heroicons with Font Awesome icons.

More about this package on FilaFly: Font Awesome icons for Filament on FilaFly.

#Installation

You can install the package via composer:

composer require filafly/filament-font-awesome-icons

Not sure which Laravel and PHP versions your Filament version needs? See the Filament version compatibility guide.

Note: This package automatically installs the required filafly/filament-icons base package.

After the package is installed, you must register the plugin in your Filament Panel provider:

use Filafly\Icons\FontAwesomeIcons;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            FontAwesomeIcons::make(),
        ]);
}

#Icon Styles

Font Awesome icons come in multiple styles that you can switch between. Available styles include:

  • Classic Solid (default)
  • Classic Regular
  • Classic Light
  • Classic Thin
  • Duotone Solid
  • Sharp Solid
  • Sharp Regular
  • Sharp Light
  • Sharp Thin
  • Sharp Duotone Solid
  • Brands

You can change the style using the following methods:

FontAwesomeIcons::make()->classicSolid(); // (default)
FontAwesomeIcons::make()->classicRegular();
FontAwesomeIcons::make()->classicLight();
FontAwesomeIcons::make()->classicThin();
FontAwesomeIcons::make()->duotoneSolid();
FontAwesomeIcons::make()->sharpSolid();
FontAwesomeIcons::make()->sharpRegular();
FontAwesomeIcons::make()->sharpLight();
FontAwesomeIcons::make()->sharpThin();
FontAwesomeIcons::make()->sharpDuotoneSolid();
FontAwesomeIcons::make()->brands();

#Override Specific Icons

If you need to override certain icons to use a different style, you can use either icon aliases or direct icon names.

#Using Icon Aliases

Use the overrideStyleForAlias method with a Filament Icon Alias. This method works with either a single icon key (string) or multiple icon keys (array).

// Override a single icon key
FontAwesomeIcons::make()->overrideStyleForAlias('tables::actions.filter', 'classicThin');

// Override multiple icon keys at once
FontAwesomeIcons::make()->overrideStyleForAlias([
    'tables::actions.filter',
    'actions::delete-action',
], 'classicThin');

#Using Icon Names

Use the overrideStyleForIcon method with the actual FontAwesome icon name. Like the alias method, this works with either a single icon name or multiple names.

// Override a single icon
FontAwesomeIcons::make()->overrideStyleForIcon('font-awesome-user', 'classicThin');

// Override multiple icons at once
FontAwesomeIcons::make()->overrideStyleForIcon([
    'font-awesome-user',
    'font-awesome-caret-up',
], 'classicThin');

#Free vs Paid

If you are using the free version of Font Awesome, you'll be limited in your style choices since the free version only includes a limited number of icons. To handle this gracefully, you can add the free() method to the plugin which will automatically fallback to Classic Solid for any icons that don't exist in Classic Regular style:

...
->plugin(
    FontAwesomeIcons::make()->classicRegular()->free()
)
...

If you are using a paid version of Font Awesome, be sure to follow the additional steps listed in the blade-fontawesome repo.

#From FilaFly

FilaFly also makes premium themes for Filament panels: Lucent, Prizm, Cypher and Citrus. Browse the themes.

#License

The MIT License (MIT). Please see License for more information.