Import and Export Notes (BIP-329 Standard) in the BitBoxApp

Table of Contents

Looking for a deeper explanation? Important notes Exporting BIP-329 labels Importing BIP-329 labels Where are the local note files stored? FAQ Are labels included in my recovery words or microSD backup? Is the export file safe to share? Can I import labels into another wallet? What happens if I lose my label file?

This article explains how to export and import wallet labels — such as account names and transaction notes — using the BIP-329 standard in the BitBoxApp.

Looking for a deeper explanation?

If you’d like to understand how wallet labels work under the hood and why BIP-329 improves portability and privacy, see our detailed blog article:
Import and export wallet labels with BIP-329

Important notes

⚠️ Privacy

The exported file contains sensitive metadata.
It includes Extended Public Keys (xpubs) and transaction IDs (hashes) for all accounts and transactions that have custom names or notes.
Treat this file as confidential and store it securely.

ℹ️ Backup strategy & Interoperability

Add regular label exports to your backup routine.
Labels are not part of your recovery words or microSD backup.
The BIP-329 format allows you to transfer your labels to any wallet that supports the standard.

Exporting BIP-329 labels

Follow these steps to export your account names and transaction notes:

Connect your BitBox02 to your computer.
Unlock the device.
(You can skip this step if the “Remember wallet” option is enabled.)
Open the BitBoxApp.
Navigate to Settings.
Select the General tab.
Scroll to the Manage notes section.

Click Export notes.
Choose a file name and storage location in your operating system’s save dialog.

Click Save.

The exported file contains everything required to restore your account names and transaction notes.

✅ Success

Your labels are now exported in BIP-329 format and can be securely stored or transferred to another compatible wallet.

Importing BIP-329 labels

Follow these steps to restore previously exported labels:

Connect your BitBox02 to your computer.
Unlock the device.
(You can skip this step if the “Remember wallet” option is enabled.)
Open the BitBoxApp.
Navigate to Settings.
Select the General tab.
Scroll to the Manage notes section.
Click Import notes.
Select the previously exported file in your operating system’s file dialog.
Click Open.

⚠️ Warning

The import file must use the .jsonl file extension.
Standard .json files are not compatible.

✅ Success

Your account names and transaction notes are now restored and visible in the BitBoxApp.

Where are the local note files stored?

The BitBoxApp also stores note files locally on your computer.

On your desktop device, navigate to:

BitBox folder → Notes

There you will find .json files representing notes for each account in plain text format.

⚠️ Warning

These local .json files are not importable.
Only .jsonl files created via the Export notes function can be imported.

FAQ

Are labels included in my recovery words or microSD backup?

No. Labels (account names and transaction notes) are not part of your wallet backup. You must export them separately.

No. The file contains sensitive metadata such as extended public keys and transaction history references. Never share it publicly.

Can I import labels into another wallet?

Yes — if the wallet supports the BIP-329 standard.

What happens if I lose my label file?

Your funds remain safe. However, your custom account names and transaction notes cannot be restored without a backup of the exported .jsonl file.