> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userpilot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Two-Factor Authentication (2FA)

> Enable Two-Factor Authentication (2FA) in Userpilot to add an extra layer of security and protect your workspace from unauthorized access.

## **Overview**

Two-Factor Authentication (2FA) adds an extra layer of security to your Userpilot account by requiring users to verify their identity using a passcode generated from an authentication app (such as Google Authenticator, 1Password, or Authy).\
This ensures that even if a password is compromised, your workspace remains protected.

## Use cases

1. You want to enhance workspace security across all teammates
2. You are working with sensitive product data or customer information
3. You are required to meet internal compliance or security guidelines
4. You use SSO and want an additional verification layer
5. You want to ensure only verified users access your Userpilot setup

## Enable 2FA

1. You can enable 2FA settings from  [******Settings → Team → Authentication → Mandatory Two-Factor Authentication******](https://run.userpilot.io/settings/team/authentication)
2. Toggle **“Require all teammates to authenticate via 2FA”** on

   <Note>
     By default, 2FA is **not required**, and teammates can log in normally. Admins can choose to enforce it for the entire team
   </Note>

   <img src="https://mintcdn.com/userpilot/okx6EgHCnXtrBzqv/images/Screenshot2025-12-14at10.45.54.png?fit=max&auto=format&n=okx6EgHCnXtrBzqv&q=85&s=8767a576fc5ff8953884c31a1e9a7a5c" alt="Screenshot2025 12 14at10 45 54 Pn" width="3178" height="2070" data-path="images/Screenshot2025-12-14at10.45.54.png" />
3. Once enabled:

   * All existing teammates will receive an **invitation to enroll in 2FA**
   * New teammates will be required to set up 2FA immediately after creating their password

   <img src="https://mintcdn.com/userpilot/okx6EgHCnXtrBzqv/images/Screenshot2025-12-14at10.51.04.png?fit=max&auto=format&n=okx6EgHCnXtrBzqv&q=85&s=d7118684ecd325224e5b12b09dc42c12" alt="Screenshot2025 12 14at10 51 04 Pn" width="2486" height="1024" data-path="images/Screenshot2025-12-14at10.51.04.png" />

   <img src="https://mintcdn.com/userpilot/okx6EgHCnXtrBzqv/images/Screenshot2025-12-14at10.53.31.png?fit=max&auto=format&n=okx6EgHCnXtrBzqv&q=85&s=6e8946dfe072b67638158962ee5fdb22" alt="Screenshot2025 12 14at10 53 31 Pn" width="1820" height="1354" data-path="images/Screenshot2025-12-14at10.53.31.png" />

   * Users can't access the workspace until they complete their 2FA setup
   * A 2FA icon appears next to their name in the Teammates table

   <img src="https://mintcdn.com/userpilot/okx6EgHCnXtrBzqv/images/Screenshot2025-12-14at11.02.46.png?fit=max&auto=format&n=okx6EgHCnXtrBzqv&q=85&s=d4f691528188fac5401b085be555dbf0" alt="Screenshot2025 12 14at11 02 46 Pn" width="3480" height="2408" data-path="images/Screenshot2025-12-14at11.02.46.png" />

<Note>
  Admins can disable 2FA for a teammate if the user is locked out of their account. For example, after losing access to their authentication device.

  <img src="https://mintcdn.com/userpilot/okx6EgHCnXtrBzqv/images/Screenshot2025-12-14at11.04.10.png?fit=max&auto=format&n=okx6EgHCnXtrBzqv&q=85&s=98d5bdd412e304785b19d1f6616ef82e" alt="Screenshot2025 12 14at11 04 10 Pn" width="3468" height="2400" data-path="images/Screenshot2025-12-14at11.04.10.png" />
</Note>

<Info>
  **Note:**\
  Team members can enable Two-Factor Authentication from **Settings → User** by scanning a QR code and activating 2FA on their account.

  However, if an admin has enforced **mandatory 2FA** for the entire workspace, users will **not** be able to disable it themselves. Only admins have permission to disable 2FA for a teammate.

  <img src="https://mintcdn.com/userpilot/okx6EgHCnXtrBzqv/images/Screenshot2025sss12-14at11.22.08.png?fit=max&auto=format&n=okx6EgHCnXtrBzqv&q=85&s=d491db7890cc41180bf94b8461548993" alt="Screenshot2025sss12 14at11 22 08 Pn" width="3696" height="2088" data-path="images/Screenshot2025sss12-14at11.22.08.png" />
</Info>
