Skip to main content
↵
Loading...

How to display tokens in MetaMask

info

MetaMask automatically displays popular ERC-20 standard tokens (Ethereum-based standard tokens) and SPL-standard tokens (Solana-based standard tokens) you own on your account page.

However, with the proliferation of tokens on Ethereum and other networks, MetaMask doesn't maintain an authoritative list of tokens — you can add any ERC-20-compliant token you hold if you don't see it in your account balance.

There are two different ways to add unlisted tokens to your MetaMask:

  • Enhanced token detection feature (enabled by default for new users on EVM-networks and Solana).
  • Manually adding a token with search or address (available on EVM-networks, Solana, and Tron).

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, zkSync, and Solana.

Token detection is enabled by default. To turn it on or off:

  • Click on the menu in the top right, navigate to 'Settings' > 'Assets'.
  • Make sure the 'Autodetect tokens' toggle is on.
  • Once done, go back to your asset list, click the 3 vertical dots in the token homepage and refresh. Hopefully, any tokens you weren't seeing before are there now. If not, try adding the token manually with search or address through the steps below.

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.

How token detection works

Enhanced token detection uses lists of tokens aggregated from various community token lists; MetaMask doesn't keep a proprietary list of 'accepted' or 'valid' tokens. Keep in mind that you should always exercise caution surrounding unfamiliar tokens:

  • Don't interact with or connect your MetaMask 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. Realize there aren't always adequate safeguards in place for the information you're seeing around the web to be worth trusting.

Adding a token with search or address​

  • Your tokens should be displayed on the tokens section of the homepage. If they're not, and automatic token detection isn't picking them up, click the three dots and select 'Manage tokens' to add a token through search or address.

  • From here you'll see a list of tokens with a toggle next to each one to display or hide it. Use the search bar at the top to find a token by name or symbol, or use the network selector to filter by network.

  • If the token you're looking for isn't in the list, scroll to the bottom and tap 'Add custom token'. Paste the token's contract address into the field, click 'Next', then 'Import'.

How to find the token address​

You can find a token's contract address using a block explorer (such as Etherscan) or a token listing site (such as Coingecko). See How to find a token contract address for step-by-step instructions.

warning

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. Be cautious and do your due diligence.

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, Tronscan, Solscan, 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)'

Etherscan add token to MetaMask menu option

  • Confirm in MetaMask to add the token

MetaMask extension add suggested tokens confirmation prompt

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

CoinMarketCap add token to MetaMask button

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 MetaMask Portfolio​

MetaMask Portfolio is a MetaMask-associated platform that aggregates and displays your token balances. Usefully, once you connect your MetaMask it automatically detects and displays the majority of tokens.

All you need to do is follow the link and connect your MetaMask. See our articles on how to use the dapp if you need more guidance.

How to hide tokens​

You can remove tokens from your asset list. Native tokens (the gas tokens for each network, such as ETH) cannot be hidden.

There are two ways to hide a token:

  1. Click the three dots in the tokens section and select 'Manage tokens'. Find the token you want to hide and toggle it off in this list.

  2. Alternatively, on your account page, click on the token you want to remove, click the three dots in the top right corner, and then 'Hide'.

MetaMask extension token view hide token dropdown option

Was this helpful?