Recovery Codes
Recovery codes get you back in if you lose your phone and your email access. Each user keeps their own codes in My Profile.
- A set is 20 codes, such as
9d3af2-8fb9b1. - Each code works once. Used codes can't be reused.
- xBit never shows unused codes again, so save them when you create them.
- Users who sign in through an external source (such as Active Directory or Microsoft Entra) can't create codes.
Open My Profile
Click your initials in the top bar.

- Two Factor Authentication: your sign-in method (With Email or With Authentication App). Click it to open the Two-factor authentication panel.
- Recovery Codes: how many codes you have left (No recovery codes generated if none). Click it to open Recovery codes.
- Set up 2FA: opens the same Two-factor authentication panel.
Set up 2FA shows only while One Time Password 2FA for login is on in About / Settings > General.
The Recovery Codes row is always there.
Two-factor authentication panel

- Setup: add an authenticator app. Email stays on as the Fallback.
- Email code: always on while 2FA is on.
- Recovery Codes: how many of the 20 codes are left. Click the row to open Recovery codes.
After you set up an authenticator app, xBit offers Generate recovery codes (or Later).
Create or replace your codes
- Click Recovery Codes on My Profile to open Recovery codes.
- Click Regenerate codes. The same button creates your first set.

- How many codes are left.
- Regenerate codes: replaces the whole set at once, without a confirmation. The old codes stop working and the used-code list is cleared.
- Revoke all codes: removes all your codes.
xBit then shows Save your recovery codes.

- Your 20 new codes.
- Copy to Clipboard, Download (a
.txtfile) or Print. - Done.
You won't be able to see these again. Download or print a copy before you click Done, and keep it somewhere safe.
Sign in with a recovery code
- On the login page, click Use Recovery Code.
- Enter your email and one unused code, then click Login.

- Use Recovery Code.

- Email.
-
Recovery code, in the format
9d3af2-8fb9b1. -
You sign in without a 2FA code and land on My Profile.
- If captcha is on at login, you must complete it first. See Captcha.
- Make a new set from My Profile soon after, as the code you used is gone.
Wrong codes lock you out
- After 3 wrong codes, the account is locked out.
- Before that, xBit warns you how many attempts are left.
- Use Recovery Code is greyed out once the attempts are used up.
- A locked-out account can't sign in with its password either.
- An Admin has to unlock it with Unlock User (see Groups / Users).

- Recovery attempts exceeded. You have been locked out of the system.
- Use Recovery Code, greyed out.
Wrong passwords have their own limit of 5 attempts.
Admins
Admins can't see or create a user's codes. They can see how many are left and which were used, and Revoke all codes, for example if the codes were exposed. See Manage a user's 2FA.