MetaMask stands as one of the most popular cryptocurrency wallets, especially among Ethereum blockchain users. While it comes pre-loaded with support for ERC-20 tokens, many users wish to manage additional tokens or even interact with tokens on other compatible blockchain networks.
Whether you're looking to trade on NFT marketplaces or engage with decentralized applications, knowing how to manually add tokens broadens your MetaMask experience. This guide provides clear instructions for both desktop and mobile users.
Why Add Custom Tokens in MetaMask?
By default, your MetaMask wallet displays major cryptocurrencies and tokens, like ETH and major ERC-20 tokens. However, thousands of other tokens exist on Ethereum and other supported networks like BNB Smart Chain (BSC). Manually adding a token allows you to:
- View your balance for that specific token directly in your wallet.
- Send and receive the token seamlessly.
- Interact with dApps that require that token.
It’s important to note that adding a token does not mean you are purchasing it; you are simply making a token that is already in your wallet visible and manageable.
Prerequisites Before You Start
Before adding any new token, ensure you have the following ready:
- The MetaMask extension installed on your browser or the mobile app on your phone.
- Your wallet must be connected to the correct blockchain network where the token resides (e.g., Ethereum Mainnet for ERC-20 tokens, BSC Mainnet for BEP-20 tokens).
- The official token contract address for the specific token you wish to add. Always obtain this from a reliable source, such as the project's official website or a trusted block explorer.
A Step-by-Step Guide to Adding Tokens on Desktop
Follow these steps to manually add a custom token using the MetaMask extension on a PC or laptop.
Step 1: Open Your MetaMask Wallet
Launch the Google Chrome browser (or your preferred Chromium-based browser like Brave) and click on the MetaMask extension icon in the top-right corner. Enter your password to unlock your wallet.
Step 2: Navigate to the "Import Tokens" Feature
At the main wallet interface, you will see a list of your current assets. Scroll to the bottom of this list and click the Import tokens link.
Step 3: Search or Manually Enter Token Details
You will now be in the "Import tokens" tab. Here, you have two options:
- Search for a Known Token: If the token is a popular one on the Ethereum network, you can often find it by typing its name or symbol in the search field. MetaMask will display it, and you can click "Next" and then "Import" to add it.
- Add a Custom Token (Most Common Method): For less common tokens or tokens on other networks, switch to the "Custom token" tab. Precisely paste the official Token Contract Address into the first field.
Upon entering the correct contract address, the Token Symbol and Decimal fields should auto-populate. This is a good sign that the address is valid.
Step 4: Confirm and Import
Click "Add Custom Token" to proceed. A confirmation screen will show the token details. Verify that everything is correct and click "Import Tokens" to complete the process. The new token will now appear in your assets list with its current balance.
👉 Explore more strategies for managing your digital assets securely
How to Add Tokens on the MetaMask Mobile App
The process is very similar on the iOS and Android mobile apps.
- Open the MetaMask app and unlock your wallet.
- On the main "Wallet" screen showing your assets, tap the "Import Tokens" button at the bottom.
- Tap on the "Custom Token" tab.
- Select the correct network at the top (e.g., Ethereum Mainnet, BNB Smart Chain).
- Paste the token’s contract address into the "Token Contract Address" field. The other fields should update automatically.
- Tap "Import" at the bottom of the screen and then confirm the action.
The token will be added to your wallet view immediately.
Important Security Considerations
When adding custom tokens, security is paramount.
- Double-Check Contract Addresses: Always verify the token contract address from multiple official sources before importing. Scammers often create fake tokens with similar names and symbols to steal funds.
- Understand the Risks: Importing a token only makes it visible. However, interacting with a malicious smart contract can pose risks. Only add tokens from projects you trust.
- You Cannot Hide a Token: Once a token is added, you cannot hide it again. You can only remove it by using the "Hide" feature, which requires the token's contract address to undo.
Frequently Asked Questions
Q1: Why can't I find my token by searching for it in MetaMask?
MetaMask's built-in search list only includes a selection of major and well-known tokens. The vast majority of tokens, especially newer or more obscure ones, must be added manually using their unique contract address.
Q2: I added a token, but my balance shows as zero. Why?
This is completely normal. Adding a token simply creates a viewport for it in your wallet. If you have not yet received any of that token to your wallet's public address, the balance will naturally be zero. The token will appear once a transaction deposits it.
Q3: Is there a fee for adding a token to MetaMask?
No, there is no cost or transaction fee associated with importing a token. It is a free, off-chain action that simply customizes your wallet's user interface.
Q4: What is a token contract address, and where do I find it?
A token contract address is a unique identifier on the blockchain, similar to a bank's routing number. You can typically find it on the project's official website, documentation, or on a block explorer like Etherscan (for Ethereum) or BscScan (for BSC).
Q5: Can I remove a token after I've added it?
Yes, you can. On the desktop extension, click on the token in your asset list to expand its details. You will see an option to "Hide" it. On mobile, swipe left on the token in your asset list and tap "Hide." Remember, this only removes it from view; it remains associated with your address on the blockchain.
Q6: Can I add any cryptocurrency, like Bitcoin, to MetaMask?
Not directly. MetaMask is designed for Ethereum and Ethereum-compatible networks (often called EVM networks). Native Bitcoin (on the Bitcoin network) cannot be held in MetaMask. However, you can hold wrapped versions of Bitcoin (like WBTC), which are ERC-20 tokens on the Ethereum blockchain.