Enable 2FA (Authenticator App)
Protect your account with a second factor
Figure — Example authenticator QR screen
Before you start
{{bg: neutral-50, round-12, px-14, py-10, display: block::
- Have your phone ready
- Install an authenticator (Google, Microsoft, Authy)
- Have a backup method (SMS/email or hardware key) }}
Tip — If you already use an authenticator, you can add a new entry for this workspace.
Steps
- Open Settings → Security → Two-factor authentication
- Choose Set up authenticator app
- On your phone, open the app and select Scan a QR code (or enter the setup key manually)
- Scan the QR shown on screen
- Enter the 6-digit code from the app (e.g., 123 456) and submit
- Save your backup codes in a password manager
- Done — You’ll be asked for a code next time you sign in
{{bg: warning-50, fg: warning-900, px-10, py-4, round-10, display: block:: {{fw-700::Heads-up}} — Changing phones? Add the new device before you wipe the old one. }}
Supported apps (examples)
| App | Notes |
|---|---|
| Google Authenticator | Simple TOTP codes |
| Microsoft Authenticator | Codes + push approvals (when supported) |
| Authy | Multi-device + optional cloud backup |
{{xs: size-13, lg: size-14, fg: gray-700::Any TOTP (time-based) authenticator works.}}
Troubleshooting
| Problem | Why it happens | Fix |
|---|---|---|
| Code invalid | Typo or wrong account | Wait for a fresh code and re-enter carefully |
| Codes always wrong | Phone time is out of sync | Enable Set automatically for date/time on your phone |
| Can’t scan QR | Camera blocked or low light | Use Enter key manually instead |
| Lost phone | Device unavailable | Use backup codes or contact support to reset 2FA |
Tip — If codes fail repeatedly, resync your authenticator time (most apps have a “Time correction” option).
Best practices
- Store backup codes safely (password manager)
- Add a second factor (e.g., hardware key) for recovery
- Avoid SMS as primary — use only as fallback
Need help? Open Help → Contact support.
