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, verify your wallet backup and make a plan to keep an exact record of your passphrase separately. 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 a secure place to keep the exact passphrase separately from your wallet backup and can access the record if you lose your 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.

 

Entering your passphrase directly on your BitBox is the safer default because it keeps the passphrase off the connected computer or phone during entry. If you choose to enter your passphrase in the BitBoxApp, use the official app on a computer or phone you trust and start the request yourself during unlock. Malicious software on that device could capture the passphrase you type or paste. Checking the passphrase on the BitBox lets you verify what the device received.

Keep your recovery words off your computer and phone, and enter your device password on the BitBox. BitBox Support will never ask for your recovery words, device password or passphrase.


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 a passphrase that’s hard to guess and that you can 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. Keep the record separate from your wallet backup so someone who finds one cannot immediately access both.

We recommend keeping your passphrase record offline. If you already keep it in a password manager, you can copy it from there and paste it into the hidden passphrase field during the official BitBoxApp unlock flow. Compare the full passphrase on your BitBox before confirming.

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

The steps below show how to enter the passphrase directly on the BitBox. If you use app entry, continue to the root fingerprint check once you’ve verified the full passphrase on the BitBox and the wallet opens.

  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 so you can compare it the next time you open the wallet.
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 the exact passphrase directly on the BitBox or in the BitBoxApp. Check the full passphrase on the BitBox display before confirming.
  3. In Settings → Manage device → Device information, compare the root fingerprint with the one you recorded for that wallet before using a receiving address or sending funds.

Open the standard wallet

  1. Unlock the BitBox with the device password.
  2. At the Optional passphrase prompt on the BitBox, leave the entry empty and submit it on the device. 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.