PHPackages                             guava/filament-icon-picker - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. guava/filament-icon-picker

ActiveLibrary[Utility & Helpers](/categories/utility)

guava/filament-icon-picker
==========================

A filament plugin that adds an icon picker field.

4.0.0(6mo ago)163718.5k↓28%41[11 issues](https://github.com/GuavaCZ/filament-icon-picker/issues)[11 PRs](https://github.com/GuavaCZ/filament-icon-picker/pulls)20MITPHPPHP ^8.2CI passing

Since Oct 7Pushed 4mo ago3 watchersCompare

[ Source](https://github.com/GuavaCZ/filament-icon-picker)[ Packagist](https://packagist.org/packages/guava/filament-icon-picker)[ Docs](https://github.com/GuavaCZ/filament-icon-picker)[ GitHub Sponsors](https://github.com/GuavaCZ)[ RSS](/packages/guava-filament-icon-picker/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (13)Versions (39)Used By (20)

[![filament-icon-picker Banner](https://github.com/GuavaCZ/filament-icon-picker/raw/main/.github/banner.png)](https://github.com/GuavaCZ/filament-icon-picker/raw/main/.github/banner.png)

Icon Picker for your filament panels
====================================

[](#icon-picker-for-your-filament-panels)

[![Latest Version on Packagist](https://camo.githubusercontent.com/b5a1a7efd7c183ca04fa68c8921667563f309fc1df791836fa561e31bba707f6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f67756176612f66696c616d656e742d69636f6e2d7069636b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/guava/filament-icon-picker)[![Total Downloads](https://camo.githubusercontent.com/5d15b5a130378b16d6627c2fc5da05320e3374b9d83fc0dfdd40192e1bd7c719/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f67756176612f66696c616d656e742d69636f6e2d7069636b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/guava/filament-icon-picker)

This plugin adds a new icon picker form field and a corresponding table column. You can use it to select from any blade-icons kit that you have installed. By default, heroicons are supported since it is shipped with Filament.

This can be useful for when you want to customize icons rendered on your frontend, if you want your users to be able to customize navigation icons, add small icons to their models for easy recognition and similar.

Documentation
-------------

[](#documentation)

The full documentation is available at [guava.cz](https://guava.cz/developers/packages/filament-icon-picker?ref=github&utm_campaign=icon-picker).

Version compatibility
---------------------

[](#version-compatibility)

Filament versionPlugin version2.x1.x3.x2.x4.x3.x5.x4.xFor older filament versions, please check the branch of the respective version.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require guava/filament-icon-picker
```

Make sure to publish the package assets using:

```
php artisan filament:assets
```

Finally, make sure you have a **custom filament theme** (read [here](https://filamentphp.com/docs/5.x/styling/overview#creating-a-custom-theme) how to create one) and add the following to your **theme.css** file so the CSS is properly built:

```
@source '../../../../vendor/guava/filament-icon-picker/resources/**/*';
```

For the remaining setup steps, please see the [installation docs](https://guava.cz/developers/packages/filament-icon-picker/4.x/installation?ref=github&utm_campaign=icon-picker).

Usage
-----

[](#usage)

Add the icon picker to any form schema:

```
use Guava\IconPicker\Forms\Components\IconPicker;

IconPicker::make('icon');
```

And the column to any table:

```
// Make sure this is the correct import, not the filament one
use Guava\IconPicker\Tables\Columns\IconColumn;

IconColumn::make('icon');
```

Everything else, including search result views, limiting icon sets and letting your users upload their own icons, is covered in the [documentation](https://guava.cz/developers/packages/filament-icon-picker).

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Lukas Frey](https://github.com/lukas-frey)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

61

—

FairBetter than 99% of packages

Maintenance69

Regular maintenance activity

Popularity57

Moderate usage in the ecosystem

Community37

Small or concentrated contributor base

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 79.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~40 days

Total

31

Last Release

205d ago

Major Versions

1.x-dev → 2.0.02023-07-21

2.3.1 → 3.0.0-beta.12025-08-19

3.1.0 → 4.0.02026-01-24

PHP version history (3 changes)1.0.0PHP ^8.1

1.3.0PHP ^8.0

3.0.0-beta.1PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/42d872f5f47cd71cfd46c8fbd6ec77a6bfb46d6d9499b5e1f843eb407c07f737?d=identicon)[Skrypt](/maintainers/Skrypt)

---

Top Contributors

[![lukas-frey](https://avatars.githubusercontent.com/u/10926334?v=4)](https://github.com/lukas-frey "lukas-frey (96 commits)")[![Voltra](https://avatars.githubusercontent.com/u/25990549?v=4)](https://github.com/Voltra "Voltra (10 commits)")[![atmonshi](https://avatars.githubusercontent.com/u/1952412?v=4)](https://github.com/atmonshi "atmonshi (4 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (2 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (2 commits)")[![chengkangzai](https://avatars.githubusercontent.com/u/43839286?v=4)](https://github.com/chengkangzai "chengkangzai (2 commits)")[![bumbummen99](https://avatars.githubusercontent.com/u/4533331?v=4)](https://github.com/bumbummen99 "bumbummen99 (1 commits)")[![ezitisitis](https://avatars.githubusercontent.com/u/6075434?v=4)](https://github.com/ezitisitis "ezitisitis (1 commits)")[![curder](https://avatars.githubusercontent.com/u/8327004?v=4)](https://github.com/curder "curder (1 commits)")

---

Tags

laravelGuavafilament-icon-picker

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/guava-filament-icon-picker/health.svg)

```
[![Health](https://phpackages.com/badges/guava-filament-icon-picker/health.svg)](https://phpackages.com/packages/guava-filament-icon-picker)
```

###  Alternatives

[backstage/mails

View logged mails and events in a beautiful Filament UI.

16429.7k](/packages/backstage-mails)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3915.5k](/packages/rawilk-profile-filament-plugin)[stephenjude/filament-feature-flags

Filament implementation of feature flags and segmentation with Laravel Pennant.

123204.9k1](/packages/stephenjude-filament-feature-flags)[marcelweidum/filament-expiration-notice

Customize the livewire expiration notice

94160.6k6](/packages/marcelweidum-filament-expiration-notice)[stephenjude/filament-two-factor-authentication

Filament Two Factor Authentication: Google 2FA + Passkey Authentication

85240.3k9](/packages/stephenjude-filament-two-factor-authentication)[marcelweidum/filament-passkeys

Use passkeys in your filamentphp app

6758.2k2](/packages/marcelweidum-filament-passkeys)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)