Quick answer: To add a custom token to MetaMask, access your wallet, navigate to ‘Import Tokens’, enter the token details, and confirm the addition.
- 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.
