How to display tokens in MetaMask

Quick links:

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:

  1. 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.
  2. Always second-guess an airdropped or unfamiliar token and do your due diligence before interacting with it. 
  3. 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. 
  4. 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.

 

Enhanced token detection

Only available on certain networks!

Enhanced token detection is only available on:

  • Ethereum mainnet
  • Avalanche
  • BNB Smart Chain
  • Polygon

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 'Advanced', and make sure the toggle is on.

Enhanced automatic token detection MetaMask

You can always turn this off later if needed.

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 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:

  1. 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.
  2. 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)
  3. Click Add token to proceed. You will be then redirected to your account page. The token you have just added will be listed.

Import token MetaMask Extension

 

How to hide tokens

Once added, you can remove the token from your asset list.

Extension Mobile

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'.

Hide token extension

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
  1. Click on 'Import tokens', located at the bottom of the 'Assets' tab on your wallet homepage.
  2. 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.
  3. 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.

     

Find custom token details

If you still can't find the token details, try locating the token's documentation through a web search.

  1. Click 'Add Custom Token' to proceed.
  2. 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.

Import custom token MetaMask Extension

 

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.
  1. Go to the block explorer.
  2. Search for your token. You can also go via the 'Tokens' link in the menu bar.
  3. Click the 'More' button in the top right of the token's profile summary.
  4. Click 'Add token to MetaMask (Web3)'

add token using block explorer

  1. MetaMask will pop up for you to confirm that you want to add the token. 

add token MetaMask notification

 

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.

Add_token_to_MetaMask_from_coin_listing_site2.gif

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. 

Using the Portfolio Dapp

The Portfolio Dapp is a new, MetaMask-associated platform that aggregates and displays your token balances. Usefully, in our context, 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.  

Articles in this section