> ## Documentation Index
> Fetch the complete documentation index at: https://lightdash-refactor-full-audit-reorg.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# User impersonation

> Temporarily view Lightdash as another user to troubleshoot user-specific issues/permissions.

<Info>
  User impersonation is behind a feature flag. [Contact support](mailto:support@lightdash.com) to enable it for your organization.
</Info>

User impersonation allows organization admins to temporarily view Lightdash as another user in their organization. This helps troubleshoot user-specific issues like permission problems, data access questions, or UI concerns without requiring the user's credentials.

## How it works

When you impersonate a user:

* You see Lightdash exactly as that user sees it, including their permissions, spaces, and data access
* A banner appears at the top of the screen indicating you're impersonating someone
* Each session has a hard limit of **15 minutes**, after which it ends automatically and returns you to your admin view
* You can stop impersonation at any time by clicking the button in the banner

Every impersonation session is audit-logged and time-limited: Lightdash records when the session starts and ends, and each request made during it carries both the impersonating user's `userUuid` and the impersonated user's `userUuid`.

If the project requires users to provide their own [personal warehouse credentials](/personal-settings/personal-warehouse-connections), queries run with the impersonated user's credentials, including SSO-backed credentials.

## Who can use impersonation

Only **organization admins** can impersonate other users. You cannot impersonate users outside your organization.

## Enabling impersonation

If user impersonation is available on your instance, organization admins can enable it from the organization settings. Once enabled, admins will be able to impersonate other users in the organization. This setting can be turned off at any time.

<Frame>
  <img src="https://mintcdn.com/lightdash-refactor-full-audit-reorg/sZ3fMhsuFhRy0pFs/images/CleanShot2026-03-12at15.38.18@2x.png?fit=max&auto=format&n=sZ3fMhsuFhRy0pFs&q=85&s=19968348bed7e4f24b0a9d3e93943629" alt="Clean Shot 2026 03 12 At 15 38 18@2x" width="1918" height="898" data-path="images/CleanShot2026-03-12at15.38.18@2x.png" />
</Frame>

## Starting impersonation

1. Go to **Settings** > **Users & Groups**
2. Find the user you want to impersonate
3. Click the **...** menu next to their name
4. Select **Impersonate user**

<Frame>
  <img src="https://mintcdn.com/lightdash-refactor-full-audit-reorg/fyNjhJAU0n2GM0Ea/images/workspace-admin/user-impersonation/impersonate-menu.png?fit=max&auto=format&n=fyNjhJAU0n2GM0Ea&q=85&s=868ff94feff251b7d99b9a94ca6a2dfc" alt="Start impersonating a user" width="1916" height="728" data-path="images/workspace-admin/user-impersonation/impersonate-menu.png" />
</Frame>

You'll immediately switch to viewing Lightdash as that user, with a banner indicating the active impersonation session.

<Frame>
  <img src="https://mintcdn.com/lightdash-refactor-full-audit-reorg/fyNjhJAU0n2GM0Ea/images/workspace-admin/user-impersonation/impersonation-banner.png?fit=max&auto=format&n=fyNjhJAU0n2GM0Ea&q=85&s=81b7afca5af49dbf1b8bc2e814674e52" alt="Impersonating a user" width="2762" height="1236" data-path="images/workspace-admin/user-impersonation/impersonation-banner.png" />
</Frame>

## Stopping impersonation

Click the **Stop impersonating** button in the banner at the top of the screen. You'll return to your normal admin view.
