How to add unlisted tokens (custom 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.

 

Advanced automatic token detection

ONLY AVAILABLE ON ETHEREUM MAINNET

Note: the GIF below shows how to access this feature in Extension, but on Mobile, you can find it in exactly the same place: Settings -> Experimental.

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:

How_To_Use_Token_Detection_Experimental_Feature.gif

 

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 

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:

import_token.png

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.

Screen_Shot_2020-12-01_at_11.04.06_AM.png

 

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

Screen_Shot_2020-12-01_at_11.13.42_AM.png

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.

    import_token.png

  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.

    empty_fields.png

  3. In most cases, the token symbol and token decimal will autofill.

    input_address.png


    If they don't, head to the network's block explorer and find the token. Its symbol and decimals will most likely be displayed.

    decimal_and_symbol.png


    If you still can't find the token details, try locating the token's documentation through a web search.
  4. Click 'Add Custom Token' to proceed.
  5. You will now see a page asking you to confirm that you want to add the token.

    confirm.png


    When you click 'Import Tokens', the token type will be added to your wallet.

 

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 three dots icon in the top right of the token's profile summary
  4. Click 'Add token to web3 wallet'
  5. MetaMask will pop up for you to confirm that you want to add the token. 

add_bat_etherscan.gif

 

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.

uniswap_address.png

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. 

Was this article helpful?
539 out of 872 found this helpful

Articles in this section

MetaMask Support on Twitter
Beware of scam Twitter accounts. Never give anyone your Secret Recovery Phrase!
MetaMask YouTube
Fow how-to and support videos please visit our channel