Bitwarden — TOTP
How to add and use automatically generated OTP codes in Bitwarden — no more waiting for SMS or email codes.
What this replaces
Instead of waiting for a 2FA code via SMS or email, or opening a separate app like Google Authenticator, the OTP code is generated automatically inside Bitwarden and auto-copies to your clipboard. Zero waiting, zero friction.
Part 1 — Admin: Adding TOTP to a Vault Item
This is done once per site by Leo or whoever manages that client's Collection. Once added, all team members with access can use it automatically.
Windows — Use the text key
You need the text secret key from the site — not the QR code. Look for "Can't scan the code?" or "Enter this key manually" when setting up 2FA on the site. Copy that text key and paste it into the Authenticator Key (TOTP) field in Bitwarden.
Mac — Scan QR code directly
On Mac, the Bitwarden browser extension lets you scan the QR code directly without needing the text key. When editing the vault item, click the camera icon next to the Authenticator Key field, point your camera at the QR code on screen, and Bitwarden captures the secret key automatically.
Watch video walkthrough (Loom)Log into Bitwarden and open the vault item
Go to vault.bitwarden.com and find the login item for the site. Click Edit.
Find the Authenticator Key field
Scroll down to find the field labelled Authenticator Key (TOTP) — it's below the password field.
Paste the secret key
Paste the text secret key from the site. It looks like: JBSWY3DPEHPK3PXP. Do not enter the QR code — only the text key works.
Save the item
Click Save. Bitwarden will immediately start generating 6-digit codes for that item.
Verify it's working
Open the item — you should see a 6-digit code with a countdown timer. If you see this, TOTP is set up correctly.
Tip — Site only shows QR code?
Use your phone to scan the QR code with any plain QR reader app. It will reveal a URL starting with otpauth://. Copy the value after secret= — that's your key. Or use the Bitwarden mobile app to scan the QR code directly.
Part 2 — Team: Using TOTP When Logging In
Once TOTP has been added to a vault item, every team member with Collection access can use it. No extra setup needed.
Navigate to the site login page
Go to the site that requires a 2FA code when logging in.
Open Bitwarden and autofill
Click the Bitwarden browser extension → find the login → click Autofill. Username and password are filled in automatically.
TOTP code auto-copies to clipboard
After autofilling, Bitwarden automatically copies the current TOTP code to your clipboard. You'll see a notification confirming this.
Paste the code
Click into the 2FA field and press Ctrl+V (Windows) or Cmd+V (Mac) to paste. Submit the form.
Troubleshooting
| Issue | Fix |
|---|---|
| Code rejected by site | Code may have expired. Wait for the next 30-second cycle and try again immediately. |
| No TOTP code showing | Admin hasn't added the key yet. Contact Leo. |
| Can't paste the code | Some sites block paste in the OTP field. Type the 6 digits manually. |
| Code always wrong | Key may have been entered incorrectly. Leo needs to re-enter from the site's 2FA settings. |