Two-step Login via Authenticator

Category: Two-step Login
On this page:

    Two-step Login using a third-party authenticator app (for example, Authy, Google Authenticator, or FreeOTP) is available for free to all Bitwarden users.


    Some authenticator apps, like Google Authenticator, do not automatically backup your 2FA tokens for easy migration to a new mobile device. In these cases, you should manually save the each token’s authenticator recovery codes.

    Other apps, like Authy, do support backup and sync across devices. In these cases, be sure to set a strong backup password and keep a record of it in your Bitwarden Vault.

    Setup an Authenticator

    Complete the following steps to enable Two-step Login using an authenticator app:


    Losing access to your authenticator app can permanently lock you out of your Vault, unless you write down and keep your Two-step Login Recovery Code in a safe place or have an alternate Two-step Login method enabled and available.

    Get your Recovery Code from the Two-step Login screen immediately after enabling any method.

    1. Log in to your Web Vault.
    2. Select Settings from the top navigation bar.
    3. Select Two-step Login from the left-side menu.
    4. Locate the Authenticator App option and select the Manage button:

      Select the Manage button
      Select the Manage button

      You will be prompted to enter your Master Password to continue.

    5. Scan the QR code with your authenticator app of choice.

      If you don’t have an authenticator app on your mobile device yet, download one and scan the QR code. We recommend Authy.

    6. Once scanned, your authenticator app will return a 6-digit verification code. Enter the code in the dialog box in your Web Vault and select the Enable button.

      A green Enabled message will indicate that Two-step Login via Authenticator App has been enabled.

    7. Select the Close button and confirm that the Authenticator App option now is enabled, as indicated by a green checkbox ( ).

    When you setup Two-step Login, you should logout of all your Bitwarden apps to immediately activate Two-step Login for each app. You will eventually be logged out automatically.

    Use an Authenticator

    The following assumes that Authenticator is your highest-priority enabled method. Complete the following steps to access your Vault using Two-step Login:

    1. Log in to your Bitwarden Vault on any app and enter your Email Address and Master Password.

      You will be prompted to Enter the 6 digit verification code from your authenticator app.

    2. Open your authenticator app and find the 6 digit verification code for your Bitwarden Vault. Enter this code on the Vault login screen. Typically, verification codes will change every 30 seconds.


      Check the Remember Me box to remember your device for 30 days. Remembering your device will mean you won’t be required to complete your Two-step Login step.

    3. Select Continue to finish logging in.

    You will not be required to complete your secondary Two-step Login step to Unlock your Vault once logged in. For help configuring Log Out vs. Lock behavior, see Vault Timeout Options.