Does this article need to be translated?
Contribute to the Help Center
Submit translations, corrections, and suggestions on GitHub, or reach out on our Community forums.
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
- Using MetaMask Portfolio
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 adds 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. See more on best practices for token safety here.
- If you attempt to transact using the token and your transaction fails, and the block explorer displays 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.
Enhanced token detection
Only available on certain networks!
Enhanced token detection is available on Ethereum Mainnet, Linea, Avalanche, BNB Smart Chain, Polygon, Arbitrum, Optimism, Base, and zkSync.
- Extension
- Mobile
If you're a new MetaMask user, token detection is enabled by default.
If you're an existing user, you might have to turn it on. To do so, click on the three verticaldots in the upper right-hand corner of the wallet view, navigate to 'Settings', and then 'Security& Privacy', and make sure the toggle is on.
Once you've enabled token detection, go back to your asset list, and refresh if necessary — hopefully, any tokens you weren't seeing before are there now.
Note that token detection takes place on Ethereum mainnet regardless of whether this setting is on or off; enhanced token detection just expands this function to cover the additional networks listed above.
Manually adding a token with search
- Extension
- Mobile
To see your tokens, click on the Tokens 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.
How to hide tokens
Once added, you can remove the token from your asset list.
- Extension
- Mobile
On your wallet page, find the 'Tokens' tab and click on the token you want to remove.
From here, click the three dots in the top right corner, and then 'Hide'.
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
- Extension
- Mobile
Click on 'Import tokens', located at the bottom of the 'Tokens' 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.
How to find the token address
Take a look at this article to see a couple of different ways to find your token address.
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 'More' button in the top right of the token's profile summary.
- Click 'Add token to MetaMask (Web3)'
- 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.
MetaMask Portfolio is a MetaMask-associated platform that aggregates and displays your token balances. Usefully, once you connect your wallet it automatically detects and displays the majority of tokens.
All you need to do is follow the link and connect your wallet. See our articles on how to use the dapp if you need more guidance.
