How to Add a Custom Token to MetaMask

Quick answer: To add a custom token to MetaMask, access your wallet, navigate to ‘Import Tokens’, enter the token details, and confirm the addition.

Key takeaways

Always double-check token addresses and network details.
Custom tokens must be on the same network as your MetaMask wallet.
Test with a small amount before making larger transactions.
Never share your seed phrase or private keys.
Be aware of potential scams and only add tokens from trusted sources.

Before you start

Ensure you have the latest version of MetaMask installed.
Have the token’s contract address, symbol, and decimal information ready.
Make sure your wallet is connected to the correct network (e.g., Ethereum, Binance Smart Chain).
Have some ETH or the native currency of the network to cover potential transaction fees.
Backup your current wallet information and seed phrase.

How to Add a Custom Token to MetaMask: step by step

1. Open MetaMask and access your wallet

Click on the MetaMask icon in your browser extension or application to open your wallet. Enter your password if prompted to unlock your wallet.

2. Navigate to ‘Import Tokens’

In the MetaMask interface, click on the ‘Assets’ tab. At the bottom of the list of your assets, click on the ‘Import tokens’ button.

3. Select ‘Custom Token’

On the ‘Import tokens’ page, you will see options to ‘Search’ and ‘Custom Token’. Click on the ‘Custom Token’ tab to enter the token details manually.

4. Enter the token contract address

In the ‘Token Contract Address’ field, input the contract address of the custom token you want to add. This is a unique identifier for the token on the blockchain.

5. Fill in the token details

Once you enter the contract address, MetaMask will automatically attempt to fill in the ‘Token Symbol’ and ‘Token Decimal’ fields. If it does not, enter these details manually. The token symbol is the abbreviation (e.g., ‘LINK’), and the decimal is the number of decimal places the token uses (usually 18).

6. Verify the token information

Double-check the contract address, symbol, and decimal information to ensure accuracy. Mistakes can lead to loss of funds or incorrect token balances.

7. Add the token to your wallet

After verifying the information, click on the ‘Add Custom Token’ button. A confirmation screen will appear showing the token details. Click ‘Import Tokens’ to finalize the addition.

8. Confirm the token in your assets

The custom token should now appear in your list of assets under the ‘Assets’ tab. You can view your balance and interact with the token directly from your MetaMask wallet.

9. Test the token with a small transaction

Before making larger transactions, consider sending a small amount of the token to another wallet or address to ensure everything is working correctly.

Fees and how long it takes

Typical fees for adding a custom token to MetaMask are minimal, often just the network transaction fee (gas fee) which can vary widely depending on network congestion. These fees are usually a small fraction of the native currency (e.g., ETH for Ethereum).

The process of adding a custom token is generally quick, taking only a few minutes. However, if the network is congested, it may take longer for transactions to process.

Tips to avoid mistakes

Always verify the token contract address from a trusted source.
Check the token’s official website or social media for the correct contract address.
Use a test network to practice adding tokens if you are unsure.
Keep your MetaMask browser extension updated to the latest version.
Consider using a hardware wallet for added security if you frequently add custom tokens.

Stay safe

Never share your seed phrase or private keys with anyone.
Only add tokens from trusted sources to avoid scams.
Be cautious of phishing sites that mimic MetaMask.
Ensure your computer and browser are free from malware.
Regularly review the list of tokens in your wallet and remove any that are no longer needed.

If something goes wrong

Token not appearing after adding — Ensure you have entered the correct contract address and network. Refresh the MetaMask interface and try again.

Incorrect token balance showing — Double-check the token’s decimal information. Incorrect decimal values can cause balance discrepancies.

MetaMask not connecting to the network — Make sure you are connected to the correct network (e.g., Ethereum Mainnet, Binance Smart Chain). Switch to the correct network in the MetaMask settings.

Transaction fee too high — Wait for network congestion to decrease or adjust the gas fee in the MetaMask settings if possible.

Doing this as part of trading, income, or a disposal? See how it may be taxed in Tax by country and the taxable-events section — information, not advice.

Frequently asked questions

Can I add any token to MetaMask?

Yes, as long as you have the correct contract address and the token is on a supported network, you can add it to MetaMask.

What if I enter the wrong contract address?

Entering the wrong contract address can result in the addition of an incorrect token or no token at all. Always verify the address before adding.

How do I remove a custom token from MetaMask?

Go to the 'Assets' tab, find the token you want to remove, click on it, and select 'Hide' or 'Remove' depending on your MetaMask version.

Can I add a token on a different network than my wallet?

No, tokens must be on the same network as your MetaMask wallet. You can switch networks in the MetaMask settings.

What if I forget the token symbol or decimal information?

You can find this information on the token's official website or blockchain explorer. MetaMask may also auto-fill these details if you enter the correct contract address.

Information, not advice. This page explains how the rules are generally understood and is not tax, legal, or financial advice. Rules change and depend on your circumstances — always check the cited source and consult a qualified professional in your jurisdiction before you act.