Quick links:
- Automatic token detection
- Adding a token using the search bar
- Adding a custom token
- Removing/hiding tokens
- Finding the token contract address
- Adding a token using the block explorer
- Adding a token using a coin listing site
Normally, MetaMask displays ERC-20 standard tokens (or standard tokens) you own on your account page. However, with the proliferation of tokens on Ethereum and other networks, MetaMask doesn't keep an authoritative list--but it does allow you to add any ERC-20 compliant token you hold.
There are two different ways to add unlisted tokens to your MetaMask wallet:
First of all, you can enable an advanced feature that automatically detects tokens held by your address, and add them to your wallet. This will use lists of tokens aggregated from various community token lists; MetaMask doesn't keep a proprietary list of 'accepted' or 'valid' tokens. If you choose this option, keep in mind that you should always exercise caution surrounding unfamiliar tokens:
- Don’t interact with or connect your wallet to any website that you’re not familiar with, you haven’t researched and have no reason to believe to be trustworthy.
- Always second-guess an airdropped or unfamiliar token and do your due diligence before interacting with it.
- When your transaction fails, and the block explorer will display an error written by the scammer directing you to a website, this is likely a phishing site, so DO NOT click this link.
- Keep informed about ways that scammers are trying to steal your funds. Realise there aren’t always adequate safeguards in place for the information you’re seeing around the web to be worth trusting.
The second method of adding tokens to your wallet—if you'd rather not use the automatic service, or if you're holding a less common token that hasn't made it onto community lists yet—is manually adding the token.
Advanced automatic token detection
Only available on certain networks!
Token detection is only available on:
- Mobile: Ethereum mainnet, Avalanche, BNB Smart Chain, Polygon
- Extension: Ethereum mainnet only
Note: the GIF below shows how to access this feature in Extension, but on Mobile, you can find it in Settings > Advanced instead.
Automatic token detection needs to be enabled by the user. It just takes a few steps. First, click on the identicon in the upper right-hand corner, navigate to 'Settings', and then 'Experimental', and make sure the toggle is on:
You can always turn this off later if needed.
Go back to your asset list, and refresh if necessary—and hopefully, any tokens you weren't seeing before are there now.
Manually adding a token with search
ONLY AVAILABLE ON ETHEREUM MAINNET
To see your tokens, click on the Assets tab. Your tokens should be listed under this tab. If they're not, and automatic token detection isn't picking them up, then click on 'Import token' at the bottom:
Clicking here will bring you to a search bar:
- Type in words contained in the token you would like to search. For example, if I would like to look for Chainlink (Symbol: LINK), I just type in "LI” in the bar, and the search bar will return all the suggestions.
- Select token of interest, and click Next to proceed. (As soon as you select a token, the button's border will be highlighted in blue)
- Click Add token to proceed. You will be then redirected to your account page. The token you have just added will be listed.
On your wallet page, find the 'Import tokens' link at the bottom of the screen:
This will bring up the search bar. Type in the name of the token you want to add:
When you find the token, tap on it to select it and then scroll down so you see the 'Import' button:
The token will now be listed under your account's assets.
How to hide tokens
Once added, you can remove the token from your asset list.
On your wallet page, find the 'Assets' tab and click on the token you want to remove.
From here, click the three dots in the top right corner, and then 'Hide'.
Long press on the token. This will bring up the option to remove it:
Long press on the token to call up the option to remove it:
If the token you search for is not among the most popular tokens, the search bar may not return the token you queried. In this case, you could add a custom token (manually).
How to add a custom token
- Click on 'Import tokens', located at the bottom of the 'Assets' tab on your wallet homepage.
- Switch to the 'Custom token' tab at the top, and then enter the token address in the first field. See below if you don't know where to find this.
- In most cases, the token symbol and token decimal will autofill.
If they don't, head to the network's block explorer and find the token. Its symbol and decimals will most likely be displayed.
If you still can't find the token details, try locating the token's documentation through a web search. - Click 'Add Custom Token' to proceed.
- You will now see a page asking you to confirm that you want to add the token.
When you click 'Import Tokens', the token type will be added to your wallet.
- Find the 'Import tokens' link from your wallet homepage. Tap it to bring up the menu for adding tokens.
- Switch over to the 'Custom token' tab. Now you'll see three fields asking for the token's contract address, its symbol, and 'Token of Precision' (i.e. how many decimal places it can go down to).
- Find the token address and paste it into the first field. The symbol and decimals should autofill:
If they don't, head to the network's block explorer and search for the token. On its page, you can easily find its symbol and decimals.
- Tap 'Import' to add it to your wallet. You'll be redirected back to your wallet homepage and be able to see it under the 'tokens' tab.
What if I don’t know the token address?
Take a look at this article to see a couple of different ways to find it.
You could also ask the person who sends you the tokens for the token's contract address.
Please be aware that if someone told you they have sent you tokens, but they are unable to provide you the token address, or the transaction hash (a unique transaction ID), it’s possible that they haven't in fact done so.
How to add a token using a block explorer
Note: In addition to Etherscan, this will work with most major block explorers, including BscScan, Polygonscan, Snowtrace, etc., as they generally share a similar design.
- Go to the block explorer
- Search for your token. You can also go via the 'Tokens' link in the menu bar.
- Click the three dots icon in the top right of the token's profile summary
- Click 'Add token to web3 wallet'
- MetaMask will pop up for you to confirm that you want to add the token.
How to add a token using a coin listing site
Sites such as Coingecko or CoinMarketCap offer MetaMask integration that allows you to add a token to MetaMask directly from its entry on their site.
To access this, simply head to one of these sites and find the token you want to add by using the search bar. Then find the contract address and click the MetaMask fox. A prompt will appear to confirm that you want to add the token to your wallet.
Note
On MetaMask Mobile, make sure you access the site using the in-app browser, rather than your device's standard browser. This is the only way to access web links that integrate with MetaMask as you can do on your desktop browser using Extension.
This method also allows you to add the token on different networks, depending on whether a corresponding smart contract has been deployed on that network by the token owners. Click the three dots next to the contract address to select a different network, and then click the fox to add the token on that network.
