Where is the MetaMask address book stored?

The MetaMask address book is stored locally in your browser’s local storage or IndexedDB, not on MetaMask servers, ensuring privacy but requiring manual backups for recovery.

Jul 01, 2025 at 05:28 pm

Understanding MetaMask Address Book Storage

MetaMask is one of the most widely used cryptocurrency wallets, offering users a convenient way to interact with decentralized applications (dApps) and manage their digital assets. One common question among users is where the MetaMask address book is stored. To understand this, it's essential to first recognize that MetaMask does not store the address book on its own servers or in a centralized database. Instead, the address book data is saved locally within the browser extension or mobile app environment.

The address book entries, such as nicknames and associated Ethereum addresses, are stored in the local storage of the browser when using the desktop version. This means that if you clear your browser cache or uninstall the extension without backing up your data, you may lose these custom labels. For the mobile version, the address book is stored within the app’s internal storage system, which is sandboxed for security purposes.

How MetaMask Handles User Data Locally

When you add an address to your MetaMask address book, the information is saved in a structured format within the browser’s IndexedDB or localStorage mechanism. These are client-side storage solutions that allow web applications like MetaMask to persistently store data without sending it to external servers.

For example, in Chrome-based browsers, you can inspect this data by opening Developer Tools > Application > Local Storage and selecting the MetaMask extension domain. There, you’ll find key-value pairs related to your wallet, including parts of the address book. However, directly manipulating this data is not recommended unless you're familiar with browser storage systems.

This local storage approach ensures that only the user has access to their labeled addresses, enhancing privacy and reducing reliance on third-party services for basic wallet functionality.

Address Book Synchronization Across Devices

Since the address book is stored locally, synchronization across devices doesn’t happen automatically unless you take specific steps. MetaMask offers a feature called MetaMask Sync, which allows users to sync their accounts, transaction history, and some settings across multiple devices using a cloud-based service. However, as of now, the address book is not included in this synchronization process.

If you want to replicate your address book on another device, you must manually re-add each contact. Alternatively, advanced users might export and import the relevant JSON files from the browser’s local storage, though this method is complex and carries risks if not done carefully.

Security Implications of Local Storage

Because the MetaMask address book resides on your device, it’s crucial to understand the security implications of local data storage. If someone gains physical or remote access to your device, they could potentially view your labeled addresses, even if they don’t have your wallet password or recovery phrase.

To mitigate this risk, always ensure your device is protected with strong passwords, biometric locks, and updated software. Additionally, avoid storing sensitive information in the address book labels, such as personal identifiers or private notes tied to public keys.

Another layer of protection involves using incognito/private browsing modes, where local storage is often cleared upon closing the session. While this can help maintain privacy, it also means any unsaved address book changes will be lost.

Exporting and Backing Up Your Address Book

Although MetaMask does not provide a direct interface for exporting or importing the address book, technically inclined users can still perform manual backups. This requires accessing the browser’s developer tools and extracting the relevant data from local storage.

To do this:

• Open Developer Tools in your browser
• Navigate to the Application tab
• Under Storage, locate Local Storage and select the MetaMask domain
• Find the entry corresponding to the address book, typically under a key like AddressBookController:addressBook
• Copy the JSON value and save it securely

This backup can later be restored by pasting the JSON back into the same field after reinstalling MetaMask or switching browsers. However, this should only be attempted if you fully understand the process, as incorrect modifications can corrupt your wallet data.

Frequently Asked Questions (FAQ)

1. Can I recover my MetaMask address book if I lose my device?

Unfortunately, unless you’ve manually backed up the address book data, there is no built-in recovery option within MetaMask. The address book is stored locally, so losing access to your device typically means losing the custom labels associated with your contacts.

2. Is it possible to share my MetaMask address book with others?

MetaMask does not offer a native feature to share your address book. However, if you wish to share certain labeled addresses with others, you can manually export the JSON data and send it to them. They would then need to import it into their own local storage.

3. Does MetaMask plan to support cloud-based address book storage?

As of now, MetaMask has not announced plans to implement cloud-based address book storage. The current design prioritizes user control and decentralization, avoiding centralized storage of sensitive wallet-related data.

4. Will clearing my browser cache delete my MetaMask address book?

Yes, clearing your browser cache or removing site data can delete your MetaMask address book if it’s stored in local storage. Always ensure you have a backup before performing such actions.