NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1149 most downloaded on Packagist
A Filament package to impersonate your users.
Latest stable
v5.7.0
Last release 18 days ago
04 Nov 2026
Release timing varies
gaps range from 2 weeks to 5 months
Some releases are documented
notes for 28 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
65 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Add Czech translation by @kojdad-alt in https://github.com/stechstudio/filament-impersonate/pull/159
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.6.1...v5.7.0
Fix sidebar offset on panels without a topbar in https://github.com/stechstudio/filament-impersonate/pull/158
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.6.0...v5.6.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add Russian, Tajik and Uzbek translations by @komyor09 in https://github.com/stechstudio/filament-impersonate/pull/156
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.5.0...v5.6.0
Scope Login/Logout impersonation clear to the impersonator's guard by @chengkangzai in https://github.com/stechstudio/filament-impersonate/pull/154
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.4.0...v5.5.0
Change cookie expiration date when Impersonating by @LuizCristino in https://github.com/stechstudio/filament-impersonate/pull/153
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.3.0...v5.4.0
Allow user to specify spa mode on redirect regardless of Filament configuration by @machacekmartin in https://github.com/stechstudio/filament-imperson
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.2.0...v5.3.0
Add Romanian translation by @ideacatlab in https://github.com/stechstudio/filament-impersonate/pull/150
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.1.0...v5.2.0
Add language support for zh_CN, zh_TW, ta, and ms by @chengkangzai in https://github.com/stechstudio/filament-impersonate/pull/149
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.0.0...v5.1.0
This is a major release that removes the lab404/laravel-impersonate dependency entirely, replacing it with a lean, native implementation purpose-built
This is a major release that removes the lab404/laravel-impersonate dependency entirely, replacing it with a lean, native implementation purpose-built for Filament — with full Octane compatibility.
All impersonation logic is now handled internally by ImpersonateManager — a stateless, Octane-safe service registered as a scoped binding. No more pulling in a general-purpose impersonation package.
Impersonation works correctly under Laravel Octane (Swoole and FrankenPHP). The package uses direct session manipulation with Laravel's stock SessionGuard, avoiding any custom guard registration that could break under Octane's request sandboxing.
A new Impersonation facade provides a clean static API:
use STS\FilamentImpersonate\Facades\Impersonation;
Impersonation::isImpersonating();
Impersonation::getImpersonator();
Impersonation::getImpersonatorId();
Impersonation::enter($from, $to, $guardName);
Impersonation::leave();
New package-owned events replace the lab404 events:
STS\FilamentImpersonate\Events\EnterImpersonationSTS\FilamentImpersonate\Events\LeaveImpersonationBoth carry $impersonator and $impersonated public properties.
When impersonation fails (e.g. incompatible guard), a Filament danger notification is now shown instead of silently doing nothing. Diagnostic Log::warning() messages are also emitted for debugging.
lab404/laravel-impersonate dependencyThe package no longer requires or uses lab404/laravel-impersonate. It will be removed from your composer.lock automatically on update.
Impersonate trait (STS\FilamentImpersonate\Models\Impersonate)The trait that was added to User models has been removed. If your User model uses this trait, remove it:
- use STS\FilamentImpersonate\Models\Impersonate;
-
class User extends Authenticatable
{
- use Impersonate;
}
If you had canImpersonate() or canBeImpersonated() methods on your model via the trait, just keep them as regular methods — the action checks for them with method_exists().
guard config keyThe filament-impersonate.guard config option has been removed. The guard is now determined by the Filament panel's auth guard. For per-action override, use ->guard('custom') on the action.
If you published the config file, you can remove the guard key.
If you listen for impersonation events, update your imports:
- use Lab404\Impersonate\Events\TakeImpersonation;
- use Lab404\Impersonate\Events\LeaveImpersonation;
+ use STS\FilamentImpersonate\Events\EnterImpersonation;
+ use STS\FilamentImpersonate\Events\LeaveImpersonation;
ImpersonateManager namespaceIf you referenced the manager directly (most users won't have), the namespace changed:
- use Lab404\Impersonate\Services\ImpersonateManager;
+ use STS\FilamentImpersonate\ImpersonateManager;
Prefer using the Impersonation facade instead.
impersonateRecord() signatureThe unused second parameter $visible has been removed:
- ->impersonateRecord($record, $visible)
+ ->impersonateRecord($record)
Octane compatibility: Replaced custom SessionGuard with direct session manipulation. The custom guard registered via Auth::extend() was not surviving
Octane compatibility: Replaced custom SessionGuard with direct session manipulation. The custom guard registered via Auth::extend() was not surviving Octane's request sandboxing, causing impersonation to fail silently under Swoole/FrankenPHP. The package now manipulates auth session keys directly using Laravel's stock SessionGuard, removing the fragile class coupling.
Failure notification: When impersonation fails, a Filament danger notification is now shown instead of silently doing nothing.
Diagnostic logging: Log::warning() is now emitted when enter() or leave() fails, with guard and user context for debugging.
LeaveImpersonation event: The $impersonated parameter is now nullable to handle edge cases where the impersonated user was soft-deleted or removed during the session.
Fixed table row action not triggering impersonation — The action callback in setUp() was missing the $record parameter, causing the impersonate button
setUp() was missing the $record parameter, causing the impersonate button on table rows to silently fail. The visible() callback was correct, so the button appeared but clicking it did nothing. (#146)See v5.0.0-beta.1 for the complete list of changes in the v5 release.
This is a major release that removes the lab404/laravel-impersonate dependency entirely, replacing it with a lean, native implementation purpose-built
This is a major release that removes the lab404/laravel-impersonate dependency entirely, replacing it with a lean, native implementation purpose-built for Filament.
All impersonation logic is now handled internally by ImpersonateManager — a stateless, Octane-safe service registered as a scoped binding. No more pulling in a general-purpose impersonation package.
A new Impersonation facade provides a clean static API:
use STS\FilamentImpersonate\Facades\Impersonation;
Impersonation::isImpersonating();
Impersonation::getImpersonator();
Impersonation::getImpersonatorId();
Impersonation::enter($from, $to, $guardName);
Impersonation::leave();
A custom SessionGuard with quietLogin() / quietLogout() methods handles user switching without firing Laravel's auth events, preserving session state during impersonation.
New package-owned events replace the lab404 events:
STS\FilamentImpersonate\Events\EnterImpersonationSTS\FilamentImpersonate\Events\LeaveImpersonationBoth carry $impersonator and $impersonated public properties.
lab404/laravel-impersonate dependencyThe package no longer requires or uses lab404/laravel-impersonate. It will be removed from your composer.lock automatically on update.
Impersonate trait (STS\FilamentImpersonate\Models\Impersonate)The trait that was added to User models has been removed. The action uses method_exists() checks, so the trait was never required. If your User model uses this trait, remove it:
- use STS\FilamentImpersonate\Models\Impersonate;
-
class User extends Authenticatable
{
- use Impersonate;
}
If you had canImpersonate() or canBeImpersonated() methods on your model via the trait, just keep them as regular methods — the action checks for them with method_exists().
guard config keyThe filament-impersonate.guard config option has been removed. The guard is now determined by the Filament panel's auth guard (which is the correct default). For per-action override, use ->guard('custom') on the action.
If you published the config file, you can remove the guard key.
If you listen for impersonation events, update your imports:
- use Lab404\Impersonate\Events\TakeImpersonation;
- use Lab404\Impersonate\Events\LeaveImpersonation;
+ use STS\FilamentImpersonate\Events\EnterImpersonation;
+ use STS\FilamentImpersonate\Events\LeaveImpersonation;
ImpersonateManager namespaceIf you referenced the manager directly (most users won't have), the namespace changed:
- use Lab404\Impersonate\Services\ImpersonateManager;
+ use STS\FilamentImpersonate\ImpersonateManager;
Prefer using the Impersonation facade instead.
impersonateRecord() signatureThe unused second parameter $visible has been removed:
- ->impersonateRecord($record, $visible)
+ ->impersonateRecord($record)
app('impersonate') / app(ImpersonateManager::class)These still work, but the recommended API is now the Impersonation facade.
enter() failure is now caught and handled before redirectingclear() now also removes stale remember-me cookie staging datacanImpersonate() boolean chain decomposed into readable guard clausesFix extra margin gap in Filament sidebar when impersonating by @jszobody in https://github.com/stechstudio/filament-impersonate/pull/145
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.1.3...4.1.4
Add fallback for missing session back_to in leave route by @jszobody in https://github.com/stechstudio/filament-impersonate/pull/140
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.1.2...4.1.3
Fix redirect handling for modal/Livewire contexts by @jszobody in https://github.com/stechstudio/filament-impersonate/pull/138
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.1.1...4.1.2
Fix banner crash in multi-panel/multi-guard setups by @jszobody in https://github.com/stechstudio/filament-impersonate/pull/137
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.1...4.1.1
Hebrew translations improvements by @zvizvi in https://github.com/stechstudio/filament-impersonate/pull/125
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.0.1...4.0.2
Graceful handling of soft-deleted impersonation targets
FILAMENT_IMPERSONATE_ROUTE_PREFIX env varFull Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.0...4.0.1
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Update README.md with correct namespace by @rbibby in https://github.com/stechstudio/filament-impersonate/pull/135
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.0.2...4.1
Filament V4 Full implementation by @TomEasterbrook in https://github.com/stechstudio/filament-impersonate/pull/117
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.16...4.0
Support for Dutch (NL) language by @rvzug in https://github.com/stechstudio/filament-impersonate/pull/82
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.8...3.9
Korean translations add by @corean in https://github.com/stechstudio/filament-impersonate/pull/78
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.7...3.8
Nothing published for this version
Fix for Filament sidebar position by @oddvalue in https://github.com/stechstudio/filament-impersonate/pull/61
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add Ukrainian translations by @devSviat in https://github.com/stechstudio/filament-impersonate/pull/111
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.15...3.16
Add Persian Language by @Danger-Mkh in https://github.com/stechstudio/filament-impersonate/pull/96
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.14...3.15
added it_IT translation by @Manoah1988 in https://github.com/stechstudio/filament-impersonate/pull/89
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.13...3.14
Added tr translation by @eneskomur in https://github.com/stechstudio/filament-impersonate/pull/88
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.12...3.13
Added pt_PT translation by @beatwiz in https://github.com/stechstudio/filament-impersonate/pull/86
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.11...3.12
Added pt_BR Localization by @RuhtracBP in https://github.com/stechstudio/filament-impersonate/pull/85
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.10...3.11
Add Hebrew language by @Omut-web in https://github.com/stechstudio/filament-impersonate/pull/84
Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.9...3.10
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
There are separate Table and Page actions now. The previous action has been moved to STS\FilamentImpersonate\Tables\Actions\Impersonate and a new STS\
STS\FilamentImpersonate\Tables\Actions\Impersonate and a new STS\FilamentImpersonate\Pages\Actions\Impersonate was introduced.auto for your banner style and it will switch between light/dark along with Filament's dark mode.Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.