Weave Code
Code Weaver
Helps Laravel developers discover, compare, and choose open-source packages. See popularity, security, maintainers, and scores at a glance to make better decisions.
Feedback
Share your thoughts, report bugs, or suggest improvements.
Subject
Message
Log in Register
Home
Packages
Filament Impersonate
Release Notes

Filament Impersonate Laravel Package

stechstudio/filament-impersonate

Filament plugin to impersonate users from your admin panel. Add an Impersonate action to resource tables or page header actions, with optional guard and redirect target. Supports SPA panels with an option to force full page loads when needed.

View on GitHub
Deep Wiki
Context7
v5.6.0

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.5.0...v5.6.0

v5.5.0

What's Changed

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.4.0...v5.5.0

v5.4.0

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.3.0...v5.4.0

v5.3.0

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.2.0...v5.3.0

v5.2.0

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.1.0...v5.2.0

v5.1.0

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/v5.0.0...v5.1.0

v5.0.0

What's New

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.

Native impersonation engine

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.

Octane support

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.

Impersonation facade

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();

Events

New package-owned events replace the lab404 events:

  • STS\FilamentImpersonate\Events\EnterImpersonation
  • STS\FilamentImpersonate\Events\LeaveImpersonation

Both carry $impersonator and $impersonated public properties.

Failure feedback

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.

Upgrading from v4

Removed: lab404/laravel-impersonate dependency

The package no longer requires or uses lab404/laravel-impersonate. It will be removed from your composer.lock automatically on update.

Removed: 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().

Removed: guard config key

The 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.

Changed: Event classes

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;

Changed: ImpersonateManager namespace

If 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.

Changed: impersonateRecord() signature

The unused second parameter $visible has been removed:

- ->impersonateRecord($record, $visible)
+ ->impersonateRecord($record)

Internal Improvements

  • 124 tests covering the manager, action, banner, route, facade, and configuration
  • Translations for all 16 supported languages
  • Updated README with current Filament v5 examples and fresh screenshots
v5.0.0-beta.3

Changes

  • 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.

v5.0.0-beta.2

Bug Fix

  • Fixed table row action not triggering impersonation — The action callback in 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)

Full Changelog

See v5.0.0-beta.1 for the complete list of changes in the v5 release.

v5.0.0-beta.1

What's New

This is a major release that removes the lab404/laravel-impersonate dependency entirely, replacing it with a lean, native implementation purpose-built for Filament.

Native impersonation engine

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 facade

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();

Custom SessionGuard

A custom SessionGuard with quietLogin() / quietLogout() methods handles user switching without firing Laravel's auth events, preserving session state during impersonation.

Events

New package-owned events replace the lab404 events:

  • STS\FilamentImpersonate\Events\EnterImpersonation
  • STS\FilamentImpersonate\Events\LeaveImpersonation

Both carry $impersonator and $impersonated public properties.

Breaking Changes

Removed: lab404/laravel-impersonate dependency

The package no longer requires or uses lab404/laravel-impersonate. It will be removed from your composer.lock automatically on update.

Removed: 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().

Removed: guard config key

The 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.

Changed: Event classes

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;

Changed: ImpersonateManager namespace

If 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.

Changed: impersonateRecord() signature

The unused second parameter $visible has been removed:

- ->impersonateRecord($record, $visible)
+ ->impersonateRecord($record)

Changed: app('impersonate') / app(ImpersonateManager::class)

These still work, but the recommended API is now the Impersonation facade.

Internal Improvements

  • Error handling: enter() failure is now caught and handled before redirecting
  • Session cleanup: clear() now also removes stale remember-me cookie staging data
  • Auth hash clearing: Simplified with a collect pipeline instead of nested conditionals
  • Code organization: Dense canImpersonate() boolean chain decomposed into readable guard clauses
  • 125 tests covering the manager, action, banner, route, facade, and configuration
4.1.4

What's Changed

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.1.3...4.1.4

4.1.3

What's Changed

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.1.2...4.1.3

4.1.2

What's Changed

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.1.1...4.1.2

4.1.1

What's Changed

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.1...4.1.1

4.1

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.0.2...4.1

4.0.2

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.0.1...4.0.2

4.0.1

What's Changed

  • Graceful handling of soft-deleted impersonation targets
  • Add FILAMENT_IMPERSONATE_ROUTE_PREFIX env var
  • Added further details to README

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/4.0...4.0.1

4.0

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.16...4.0

3.16

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.15...3.16

3.15

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.14...3.15

3.14

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.13...3.14

3.13

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.12...3.13

3.12

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.11...3.12

3.11

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.10...3.11

3.10

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.9...3.10

3.9

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.8...3.9

3.8

What's Changed

New Contributors

Full Changelog: https://github.com/stechstudio/filament-impersonate/compare/3.7...3.8

3.7
3.6.1

Fixes #67

3.6
3.5
Weaver

How can I help you explore Laravel packages today?

Conversation history is not saved when not logged in.
Prompt
Add packages to context
No packages found.
terminal42/code-quality-tools
codifyo/ts-generator-bundle
andydefer/laravel-cluster
testo/fiber
mintobit/jobqueue
a4sex/maintenance-bundle
a4sex/entity-date-update
a4sex/client-identifier
a4sex/base-utilites
a4sex/key-value-storage
a4sex/micro-status
chilldev/dependency-injection-extra
datinglibre/datinglibre-app-api
biberltd/corebundle
bricre/symfony-bundle-test
biberltd/logbundle
dominium/http-adapter-bundle
dominium/google-analytics
a4sex/auto-clean-entity
christhompsontldr/laravel-inky