PHPackages                             tomatophp/filament-users - 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. [Authentication & Authorization](/categories/authentication)
4. /
5. tomatophp/filament-users

ActiveLibrary[Authentication & Authorization](/categories/authentication)

tomatophp/filament-users
========================

Manage your users with a highly customizable user resource for FilamentPHP with integration of filament-shield and filament-impersonate

5.0.0(3mo ago)90102.0k↑12.9%29[5 PRs](https://github.com/tomatophp/filament-users/pulls)7MITPHPPHP ^8.2|^8.3|^8.4CI passing

Since Sep 28Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/tomatophp/filament-users)[ Packagist](https://packagist.org/packages/tomatophp/filament-users)[ GitHub Sponsors](https://github.com/fadymondy)[ RSS](/packages/tomatophp-filament-users/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (12)Versions (45)Used By (7)

[![Screenshot](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/fadymondy-tomato-users.jpg)](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/fadymondy-tomato-users.jpg)

Filament Users Manager
======================

[](#filament-users-manager)

[![Dependabot Updates](https://github.com/tomatophp/filament-users/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/tomatophp/filament-users/actions/workflows/dependabot/dependabot-updates)[![PHP Code Styling](https://github.com/tomatophp/filament-users/actions/workflows/fix-php-code-styling.yml/badge.svg)](https://github.com/tomatophp/filament-users/actions/workflows/fix-php-code-styling.yml)[![Tests](https://github.com/tomatophp/filament-users/actions/workflows/tests.yml/badge.svg)](https://github.com/tomatophp/filament-users/actions/workflows/tests.yml)[![Latest Stable Version](https://camo.githubusercontent.com/1d15c03ac6f81d8a3e57f16867333a409a2815415b490a69b2d9a9520d6101e5/68747470733a2f2f706f7365722e707567782e6f72672f746f6d61746f7068702f66696c616d656e742d75736572732f76657273696f6e2e737667)](https://packagist.org/packages/tomatophp/filament-users)[![License](https://camo.githubusercontent.com/aa1b0f23ddce81a468736a27d756033edf8be99bb3b96eae1c7eb0267b0b9252/68747470733a2f2f706f7365722e707567782e6f72672f746f6d61746f7068702f66696c616d656e742d75736572732f6c6963656e73652e737667)](https://packagist.org/packages/tomatophp/filament-users)[![Downloads](https://camo.githubusercontent.com/66087e4e2b574f2b563df7e72832f5c55615d7b2c291d08106da37ce79849c64/68747470733a2f2f706f7365722e707567782e6f72672f746f6d61746f7068702f66696c616d656e742d75736572732f642f746f74616c2e737667)](https://packagist.org/packages/tomatophp/filament-users)

Manage your users with a highly customizable user resource for FilamentPHP with integration of filament-shield and filament-impersonate.

for filament v2 please use this [repo](https://github.com/3x1io/filament-user)

Features
--------

[](#features)

- Users Resource
- Allow To Publish User Resource
- Allow To Use Shield
- Allow To Use Impersonate
- Allow To Use Facade Class to custom the current user resource
- Integration with Laravel Jetstream teams
- custom User model from config file
- custom Team model from config file
- custom Role model from config file
- Allow User Avatars
- Laravel Jetsream user profile page
- Custom Register/Login Pages for Laravel Jetstream
- Add OTP Page to Register process

Screenshots
-----------

[](#screenshots)

[![Users List](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/user-list.png)](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/user-list.png)[![Create User](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/create.png)](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/create.png)[![Edit User](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/edit.png)](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/edit.png)[![Users Filters](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/filters.png)](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/filters.png)[![Delete Current User](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/delete-current-user.png)](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/delete-current-user.png)[![Impersonate](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/impersonate.png)](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/impersonate.png)[![Shield](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/shield.png)](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/shield.png)[![Roles Bulk Action](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/roles.png)](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/roles.png)[![Edit Roles](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/edit-roles.png)](https://raw.githubusercontent.com/tomatophp/filament-users/master/arts/edit-roles.png)

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

[](#installation)

```
composer require tomatophp/filament-users
```

finally register the plugin on `/app/Providers/Filament/AdminPanelProvider.php`

```
->plugin(\TomatoPHP\FilamentUsers\FilamentUsersPlugin::make())
```

Use Filament Shield
-------------------

[](#use-filament-shield)

you can use the shield to protect your resource and allow user roles by install it first

```
composer require bezhansalleh/filament-shield
```

Add the Spatie\\Permission\\Traits\\HasRoles trait to your User model(s):

```
use Illuminate\Foundation\Auth\User as Authenticatable;
use Spatie\Permission\Traits\HasRoles;

class User extends Authenticatable
{
    use HasRoles;

    // ...
}
```

Publish the config file then setup your configuration:

```
->plugin(\BezhanSalleh\FilamentShield\FilamentShieldPlugin::make())
```

Now run the following command to install shield:

```
php artisan shield:setup
php artisan shield:super_admin
```

Now we can publish the package assets.

```
php artisan vendor:publish --tag="filament-users-config"
```

now on your `filament-users.php` config allow shield

```
/*
 * User Filament Shield
 */
"shield" => true,
```

now clear your config

```
php artisan config:cache
php artisan optimize
```

for more information check the [Filament Shield](https://github.com/bezhanSalleh/filament-shield)

Use Filament Impersonate
------------------------

[](#use-filament-impersonate)

now on your `filament-users.php` config allow shield

```
/*
 * User Filament Impersonate
 */
"impersonate" => [
    'enable' => true
],
```

now clear your config

```
php artisan config:cache
php artisan optimize
```

Use Laravel Jetstream Teams
---------------------------

[](#use-laravel-jetstream-teams)

you can use the Laravel Jetstream Teams by install it first

```
composer require laravel/jetstream
```

after that just publish the migration and models

```
php artisan filament-users:teams
```

now you need to migrate the teams migration

```
php artisan migrate
```

now on your `filament-users.php` config allow shield

```
/*
 * User Filament Teams
 */
"teams" => true,
```

now clear your config

```
php artisan config:cache
php artisan optimize
```

Publish Resource
----------------

[](#publish-resource)

you can custom the resource by just extend it and then make `->useUserResource(false)` or `->useTeamsResource(false)` to the plugin

Register User Relation Manager
------------------------------

[](#register-user-relation-manager)

you can register the user relation manager to your project

```
use TomatoPHP\FilamentUsers\Facades\FilamentUser;

public function boot()
{
    FilamentUser::register([
        \Filament\Resources\RelationManagers\RelationManager::make() // Replace with your custom relation manager
    ]);
}
```

User Users Resource Hooks
-------------------------

[](#user-users-resource-hooks)

we have add a lot of hooks to make it easy to attach actions, columns, filters, etc

### Table Columns

[](#table-columns)

```
use TomatoPHP\FilamentUsers\Filament\Resources\Users\Tables\UserTable;

public function boot()
{
    UsersTable::register([
        \Filament\Tables\Columns\TextColumn::make('something')
    ]);
}
```

### Table Actions

[](#table-actions)

```
use TomatoPHP\FilamentUsers\Filament\Resources\Users\Tables\UserActions;

public function boot()
{
    UserActions::register([
        \Filament\Tables\Actions\ReplicateAction::make()
    ]);
}
```

### Table Filters

[](#table-filters)

```
use TomatoPHP\FilamentUsers\Filament\Resources\Users\Tables\UserFilters;

public function boot()
{
    UserFilters::register([
        \Filament\Tables\Filters\SelectFilter::make('something')
    ]);
}
```

### Table Bulk Actions

[](#table-bulk-actions)

```
use TomatoPHP\FilamentUsers\Filament\Resources\Users\Tables\UserBulkActions;

public function boot()
{
    UserBulkActions::register([
        \Filament\Tables\BulkActions\DeleteAction::make()
    ]);
}
```

### From Components

[](#from-components)

```
use TomatoPHP\FilamentUsers\Filament\Resources\Users\Schemas\UserForm;

public function boot()
{
    UserForm::register([
        \Filament\Forms\Components\TextInput::make('something')
    ]);
}
```

### Infolist Entries

[](#infolist-entries)

```
use TomatoPHP\FilamentUsers\Filament\Resources\Users\Schemas\UserInfolist;

public function boot()
{
    UserInfolist::register([
       \Filament\Infolists\Components\TextEntry::make('something')
    ]);
}
```

Custom Resource Classes
-----------------------

[](#custom-resource-classes)

you can customize all resource classes to be any class you want with the same return from the config file

```
/**
 * ---------------------------------------------
 * Resource Building
 * ---------------------------------------------
 * if you want to use the resource custom class
 */
'resource' => [
    'table' => [
        'class' => \TomatoPHP\FilamentUsers\Resources\UserResource\Table\UserTable::class,
        'filters' => \TomatoPHP\FilamentUsers\Resources\UserResource\Table\UserFilters::class,
        'actions' => \TomatoPHP\FilamentUsers\Resources\UserResource\Table\UserActions::class,
        'bulkActions' => \TomatoPHP\FilamentUsers\Resources\UserResource\Table\UserBulkActions::class,
    ],
    'form' => [
        'class' => \TomatoPHP\FilamentUsers\Resources\UserResource\Schemas\UserForm::class
    ],
    'infolist' => [
        'class' => \TomatoPHP\FilamentUsers\Resources\UserResource\Schemas\UserInfolist::class
    ]
]
```

Use Simple User Resource
------------------------

[](#use--simple-user-resource)

you can use the simple user resource by change on config, on your `filament-users.php` config allow simple

```
/**
 * ---------------------------------------------
 * Use Simple Resource
 * ---------------------------------------------
 * change the resource from pages to modals by allow simple resource.
 */
'simple' => true,
```

Use User Avatar
---------------

[](#use-user-avatar)

you can use User Avatar by just add `->useAvatar()` to the plugin

Publish Assets
--------------

[](#publish-assets)

you can publish config file by use this command

```
php artisan vendor:publish --tag="filament-users-config"
```

you can publish languages file by use this command

```
php artisan vendor:publish --tag="filament-users-lang"
```

Testing
-------

[](#testing)

if you like to run `PEST` testing just use this command

```
composer test
```

Code Style
----------

[](#code-style)

if you like to fix the code style just use this command

```
composer format
```

PHPStan
-------

[](#phpstan)

if you like to check the code by `PHPStan` just use this command

```
composer analyse
```

Other Filament Packages
-----------------------

[](#other-filament-packages)

Checkout our [Awesome TomatoPHP](https://github.com/tomatophp/awesome)

###  Health Score

61

—

FairBetter than 99% of packages

Maintenance78

Regular maintenance activity

Popularity49

Moderate usage in the ecosystem

Community33

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 79.2% 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 ~21 days

Recently: every ~42 days

Total

41

Last Release

116d ago

Major Versions

v1.0.13 → v2.x-dev2024-10-17

2.0.19 → v4.x-dev2025-08-05

4.0.3 → 5.0.02026-01-22

PHP version history (2 changes)v1.0.0PHP ^8.1|^8.2

2.0.17PHP ^8.2|^8.3|^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/2147eb2fca7ab5f0124d0fafd88ba2d2a5dfa3a0036fb8872d1084b7cba29366?d=identicon)[fadymondy](/maintainers/fadymondy)

![](https://www.gravatar.com/avatar/809bc5f4a4ab60764ebeceed2fd4156b85118e5abe77a66a50977c083f1cc7ca?d=identicon)[queents](/maintainers/queents)

---

Top Contributors

[![fadymondy](https://avatars.githubusercontent.com/u/11937812?v=4)](https://github.com/fadymondy "fadymondy (126 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (8 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (3 commits)")[![joshuavdhof](https://avatars.githubusercontent.com/u/9946867?v=4)](https://github.com/joshuavdhof "joshuavdhof (2 commits)")[![slamservice](https://avatars.githubusercontent.com/u/41155893?v=4)](https://github.com/slamservice "slamservice (2 commits)")[![bretto36](https://avatars.githubusercontent.com/u/6217994?v=4)](https://github.com/bretto36 "bretto36 (2 commits)")[![victorelec14](https://avatars.githubusercontent.com/u/543450?v=4)](https://github.com/victorelec14 "victorelec14 (2 commits)")[![kolaente](https://avatars.githubusercontent.com/u/13721712?v=4)](https://github.com/kolaente "kolaente (1 commits)")[![LeanderVanBaekel](https://avatars.githubusercontent.com/u/6113314?v=4)](https://github.com/LeanderVanBaekel "LeanderVanBaekel (1 commits)")[![manuelcookis](https://avatars.githubusercontent.com/u/237064696?v=4)](https://github.com/manuelcookis "manuelcookis (1 commits)")[![presidenwashil](https://avatars.githubusercontent.com/u/108395093?v=4)](https://github.com/presidenwashil "presidenwashil (1 commits)")[![rpsimao](https://avatars.githubusercontent.com/u/205846?v=4)](https://github.com/rpsimao "rpsimao (1 commits)")[![shibomb](https://avatars.githubusercontent.com/u/958471?v=4)](https://github.com/shibomb "shibomb (1 commits)")[![tecncr](https://avatars.githubusercontent.com/u/72332975?v=4)](https://github.com/tecncr "tecncr (1 commits)")[![KalimeroMK](https://avatars.githubusercontent.com/u/24772657?v=4)](https://github.com/KalimeroMK "KalimeroMK (1 commits)")[![andrii-trush](https://avatars.githubusercontent.com/u/14265776?v=4)](https://github.com/andrii-trush "andrii-trush (1 commits)")[![anselmobattisti](https://avatars.githubusercontent.com/u/86752?v=4)](https://github.com/anselmobattisti "anselmobattisti (1 commits)")[![EngALAlfy](https://avatars.githubusercontent.com/u/61562847?v=4)](https://github.com/EngALAlfy "EngALAlfy (1 commits)")[![JanneDeVos](https://avatars.githubusercontent.com/u/75279277?v=4)](https://github.com/JanneDeVos "JanneDeVos (1 commits)")[![AlexHaible](https://avatars.githubusercontent.com/u/52239823?v=4)](https://github.com/AlexHaible "AlexHaible (1 commits)")

---

Tags

authenticationfilamentphpuseruser-cruduser-resourcephplaravelUser managementUsersfilamentphpfilament-shieldfilament-impersonateuser CRUDuser resource

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/tomatophp-filament-users/health.svg)

```
[![Health](https://phpackages.com/badges/tomatophp-filament-users/health.svg)](https://phpackages.com/packages/tomatophp-filament-users)
```

###  Alternatives

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[marcelweidum/filament-passkeys

Use passkeys in your filamentphp app

5925.8k](/packages/marcelweidum-filament-passkeys)[tomatophp/filament-cms

Full CMS System with support of importing integrations and multi meta functions

11410.4k4](/packages/tomatophp-filament-cms)[tomatophp/filament-icons

Picker & Table Column & Icons Provider for FilamentPHP

3598.2k13](/packages/tomatophp-filament-icons)[tomatophp/filament-developer-gate

Secure your selected route by using a middleware with static password for developers only

11106.7k6](/packages/tomatophp-filament-developer-gate)[tomatophp/filament-types

Manage any type on your app in Database with easy to use Resource for FilamentPHP

5616.7k8](/packages/tomatophp-filament-types)

PHPackages © 2026

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