Enable the optional passphrase prompt to open a separate wallet from the same wallet backup. After unlocking your BitBox with its device password, enter your exact passphrase to open that wallet, or leave the prompt empty to open your standard wallet.

Before enabling the prompt, make sure you have a verified wallet backup and a way to store the exact passphrase offline, separately from that backup. You need both to restore the passphrase-protected wallet.


Before you enable the optional passphrase

Continue only when:

  • You have verified the microSD backup or recovery words for the wallet on your BitBox.
  • You have decided how to record and store the exact passphrase offline and separately from the wallet backup. The passphrase is not included in that backup and cannot be recovered by BitBox.
  • You understand how a passphrase creates separate wallets. If you need a refresher, read How does a passphrase work?

If you are still deciding whether the added security is worth the additional recovery responsibility, read Benefits and risks of using an optional passphrase before enabling the feature.

Passphrase recovery warning

If you lose the exact passphrase, your wallet backup alone cannot restore the passphrase-protected wallet. BitBox cannot recover or reset the passphrase, and losing it can permanently block access to the funds in that wallet.

 

Never enter your recovery words or passphrase into the BitBoxApp, a website, a password manager, a cloud service, a chat, or an AI tool. Enter and verify the passphrase only on your BitBox. BitBox Support will never ask you for it.


Enable the optional passphrase

  1. Open the BitBoxApp, connect your BitBox, and unlock it with the device password.
  2. In the BitBoxApp, open Settings and select Manage device.
  3. Under Expert settings, select Passphrase. Its current status should be Disabled.
  4. Select Enable optional passphrase and read the information shown in the BitBoxApp. On the final screen, select Enable passphrase.
  5. Confirm the change on your BitBox when prompted.
  6. Disconnect and reconnect the BitBox. After you enter the device password, it will now ask for an optional passphrase.
Passphrase setting under Expert settings in the BitBoxApp

Enabling the feature does not create one fixed passphrase or store one on the device. The wallet that opens depends on what you enter at the passphrase prompt.


Choose and record a strong passphrase

Choose the passphrase before you enter it on the BitBox. It needs to be difficult for someone else to guess or brute-force, while remaining possible for you to record and reproduce exactly.

  • Length: Use at least 12 randomly selected characters. Longer can provide more strength when the additional characters are also unpredictable.
  • Randomness: Do not use names, dates, personal information, quotations, keyboard patterns, or another password you already use. A randomly generated sequence is safer than one composed from familiar information.
  • Character variety: A random combination of uppercase letters, lowercase letters, numbers, and symbols can provide strong protection. Simply adding predictable substitutions, such as replacing an a with @, does not make an otherwise predictable passphrase strong.
  • Accuracy: Record the passphrase exactly, including capitalization, spaces, and symbols. Store it offline and separately from your wallet backup. Do not rely on memory alone.

When you enter an optional passphrase on your BitBox, you can use up to 149 characters:

  • Uppercase letters: A-Z
  • Lowercase letters: a-z
  • Numbers: 0-9
  • Spaces
  • Symbols: ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ { | }

The on-device keyboard does not support backticks (`), tildes (~), section signs (§), accented letters or emoji.

Every supported character is significant. For example, a space, a capital letter, or a symbol produces a different wallet from an otherwise identical passphrase.


Open your first passphrase-protected wallet

  1. Unlock your BitBox with its device password. The device shows the Optional passphrase prompt.
  2. Tap the top edge above the label in the center to switch layouts. That label previews the next layout. The character groups along the bottom show the active layout.
Lowercase letters on the BitBox passphrase keyboard
Lowercase. Tap above ABC to switch to uppercase.
Uppercase letters on the BitBox passphrase keyboard
Uppercase. Tap above 123 to switch to numbers.
Numbers on the BitBox passphrase keyboard
Numbers. Tap above &?+ to switch to symbols and space.
Symbols and space on the BitBox passphrase keyboard
Symbols and space. Tap above abc to return to lowercase.
  1. Tap the bottom edge below the group that contains the character you want. Keep selecting the smaller groups until you can select the character itself. Use the symbols layout to enter a space.
  2. When you finish entering the passphrase, hold the top and bottom touch sensors at the right end until the device moves to the review prompt. If the review prompt appears after you enter the 149th character, continue there.
  3. Advance to the Confirm screen. Scroll if needed and compare the full entry with the passphrase you recorded, including capitalization, spaces and symbols. Confirm only if it matches exactly. If you see a mistake, reject the entry and try again.

The BitBoxApp now opens the wallet derived from your wallet backup and that exact passphrase. Do not receive a meaningful amount yet. First, record its root fingerprint and confirm that you can reopen the same wallet.


Record the wallet's root fingerprint

The root fingerprint is a short identifier derived from the wallet currently open. A different passphrase normally produces a different root fingerprint, making it useful for distinguishing your standard wallet from your passphrase-protected wallets.

  1. In the BitBoxApp, go to Settings and select Manage device.
  2. Under Device information, find Root fingerprint.
  3. Record the fingerprint with a name that clearly identifies this wallet. Keep the record available for future checks, but do not write the passphrase beside your wallet backup.
Root fingerprint under Device information in the BitBoxApp

The root fingerprint is not a private key and cannot be used to spend funds. It is a short identifier rather than an absolute proof, so use it together with the reopening and small-amount test below. You can learn more in What account details mean in the BitBoxApp.


Confirm that you can reopen the same wallet

Complete this test before transferring a meaningful amount to the passphrase-protected wallet:

Do not transfer meaningful funds yet

A passphrase typo creates a different wallet without showing an error. Transfer a meaningful amount only after you have reopened the wallet, matched its root fingerprint, and confirmed a small test transaction.

 
  1. Disconnect and reconnect your BitBox.
  2. Unlock it with the device password. Enter the exact passphrase from your separately stored record and verify the complete entry on the BitBox display.
  3. Return to Settings → Manage device → Device information and compare the root fingerprint with the one you recorded. If it differs, stop here and follow the wallet checks below.
  4. Generate a receiving address and verify the complete address on the BitBox display. Send only a small practical test amount to that address and wait for the transaction to confirm.
  5. Disconnect and reconnect once more. Enter the same passphrase, compare the root fingerprint again, and confirm that the test transaction appears in the wallet.

You have verified the setup when you can reopen the wallet from your stored passphrase, match the recorded root fingerprint and see the confirmed test transaction. Complete those checks before transferring a larger amount.


Access your wallets later

When the optional passphrase feature is enabled, the entry at the passphrase prompt determines which wallet opens.

Open a passphrase-protected wallet

  1. Unlock the BitBox with the device password.
  2. Enter and verify the exact passphrase on the BitBox.
  3. In Settings → Manage device → Device information, compare the root fingerprint with the one you recorded for that wallet before receiving or sending a meaningful amount.

Open the standard wallet

  1. Unlock the BitBox with the device password.
  2. At the Optional passphrase prompt, leave the entry empty and submit it. The standard wallet opens without a separate passphrase review.

The standard wallet is derived from your wallet backup without a passphrase. It normally has a different root fingerprint from wallets derived using a passphrase.


If the wallet is empty or looks unfamiliar

If a wallet looks unfamiliar, pause before sending funds or using a receiving address. A typo can open a different wallet without an error. An empty wallet can also reflect accounts that are missing or still synchronizing.

  • The root fingerprint differs from your record. Disconnect and reconnect the BitBox. Re-enter the exact passphrase and review every character on the device. If the fingerprint still differs after a restore, check that you used the backup for the intended wallet.
  • The fingerprint matches, or you have no earlier fingerprint to compare. A match is a useful clue. Check that the expected accounts and transaction history appear before using the wallet. Follow the missing accounts guide to check the wallet and account setup.

If you still cannot identify the wallet, contact BitBox Support with your device model, app and firmware versions, and the step where you got stuck. Keep your passphrase and wallet backup private. BitBox Support cannot recover them for you.


Disable or re-enable the optional passphrase

Disabling the feature removes the passphrase prompt. It does not change or delete your standard wallet or any passphrase-protected wallet, and it does not move funds.

Before disabling the feature, make sure you still have the exact passphrase and the recorded root fingerprint for every passphrase-protected wallet you intend to access again.

  1. Open the BitBoxApp, connect your BitBox, and unlock it. You can perform this action while either the standard wallet or a passphrase-protected wallet is open.
  2. Go to Settings → Manage device → Expert settings → Passphrase.
  3. Select Disable optional passphrase and confirm the change on your BitBox.

After disabling the feature, unlocking the BitBox opens the standard wallet without showing a passphrase prompt. To access a passphrase-protected wallet again, return to the same setting, re-enable the feature, reconnect the device, and enter the exact passphrase. Confirm the expected root fingerprint before using the wallet.


Move funds to a wallet with a different passphrase

An existing passphrase cannot be edited or reset. Entering a different passphrase creates a different wallet; it does not change the passphrase of the original wallet.

First open the wallet with the new passphrase and follow the verification steps above. Verify its receiving address on the BitBox. Then reopen the wallet with the original passphrase and send the funds to the verified address. Keep access to the original wallet until you have reopened the new wallet and confirmed the transfer there.