How to View and Manage Tokens in MetaMask

·

MetaMask is a powerful and popular Web3 wallet that allows you to manage a wide range of digital assets, including tokens built on the Ethereum standard (ERC-20) and other compatible networks. By default, MetaMask displays the standard tokens you own on your account page. However, due to the vast number of tokens available across multiple blockchains, it does not maintain a proprietary list of all tokens. Instead, it provides flexible tools for you to manually or automatically add and manage the tokens you hold.

This guide will walk you through the various methods to view, add, and hide tokens within your MetaMask wallet, whether you're using the browser extension or the mobile app.

Understanding Token Detection in MetaMask

MetaMask supports two primary methods for adding unlisted tokens to your wallet:

  1. Automatic Token Detection: A feature that scans your wallet address and automatically adds detected tokens using aggregated community token lists.
  2. Manual Token Addition: You can manually search for and add tokens or input a token's contract address directly.

It's crucial to exercise caution, especially with unfamiliar tokens. Always research a token thoroughly before interacting with it, and never connect your wallet to unverified websites. Be wary of unsolicited token airdrops and potential phishing attempts disguised as transaction errors.

👉 Explore advanced wallet safety practices

Enabling Enhanced Token Detection

Enhanced token detection automates the process of finding and displaying tokens in your wallet. This feature is available on several major networks, including:

For new users, this feature is typically enabled by default. Existing users may need to activate it manually.

How to Enable Enhanced Detection

  1. In your MetaMask wallet, click the three vertical dots in the upper right corner.
  2. Navigate to Settings > Security & Privacy.
  3. Locate the toggle for enhanced token detection and ensure it is switched on.

Once enabled, return to your assets list and refresh the page. Any tokens held by your address on the supported networks should now be visible.

Note: Basic token detection on Ethereum mainnet occurs regardless of this setting. The enhanced feature simply extends this functionality to the other networks listed above.

Manually Adding a Token Using the Search Bar

If automatic detection doesn't find your token, you can add it manually via the search function.

Step-by-Step Guide

  1. Navigate to the Tokens tab on your wallet's main page.
  2. If your token isn't listed, click the Import tokens link at the bottom.
  3. A search bar will appear. Type in part of the token's name or symbol (e.g., typing "D" will bring up suggestions like DAI).
  4. Select the correct token from the list. The selection will be highlighted in blue.
  5. Click Next and then Import to add the token to your wallet. You will be redirected to your account page, where the new token will now be listed.

How to Hide or Remove Tokens

You can clean up your asset view by hiding tokens you no longer wish to see.

  1. From your wallet's main page, go to the Tokens tab.
  2. Click on the specific token you want to remove.
  3. Click the three dots in the top right corner of the token's detail view.
  4. Select Hide from the menu.

The token will be removed from your primary asset list. Please note that this action does not remove the tokens from your wallet; it only hides them from view.

Adding a Custom Token by Contract Address

For tokens not found in the search database, you will need to add them as a custom token using their unique contract address.

How to Add a Custom Token

  1. Under the Tokens tab, click the three dots and select Import tokens.
  2. Switch to the Custom token tab.
  3. Select the correct network from the dropdown menu (e.g., Ethereum, Polygon, BSC).
  4. Carefully paste the token's contract address into the designated field.
  5. The other fields (Token Symbol and Decimals of Precision) should auto-populate. If they do not, double-check the address for accuracy.
  6. Click Import to add the token.

👉 Get detailed steps for managing custom assets

How to Find a Token's Contract Address

The contract address is a unique identifier necessary for adding custom tokens. You can find it in several ways:

Important Warning: If someone claims to have sent you tokens but cannot provide a transaction hash (TXID) or the token's contract address, they may not have sent the tokens. Always verify such claims through a block explorer.

Using a Block Explorer to Add Tokens

Most major block explorers offer a direct function to add tokens to MetaMask.

  1. Navigate to a block explorer like Etherscan or BscScan.
  2. Search for the token you want to add.
  3. On the token's profile page, look for a button labeled "Add to MetaMask," "Add to Web3 Wallet," or similar (often found under a "More" menu).
  4. Clicking this button will trigger a MetaMask pop-up asking you to confirm the token addition.

Adding Tokens via Coin Listing Sites

Websites like CoinGecko and CoinMarketCap provide seamless integration with MetaMask.

  1. Go to CoinGecko or CoinMarketCap and find your token using the search bar.
  2. On the token's page, locate the contract address section.
  3. You will typically see a MetaMask fox icon next to the address. Click it.
  4. A confirmation prompt will appear in your MetaMask wallet. Confirm to add the token.

Mobile Note: When using MetaMask Mobile, ensure you are accessing these sites through the built-in in-app browser to enable proper integration with the wallet.

These sites often list contract addresses for the same token on multiple networks. You can use the same process to add the token to different networks within your wallet.

Automatically View Tokens with MetaMask Portfolio

MetaMask Portfolio is a powerful companion dapp that automatically aggregates and displays your token balances across all connected networks after you link your wallet.

  1. Visit portfolio.metamask.io.
  2. Connect your MetaMask wallet.
  3. The platform will automatically scan your address and display your holdings, including many tokens that may not appear in your main wallet view.

This is an excellent tool for getting a comprehensive overview of your entire cryptocurrency portfolio without manually adding each token.

Frequently Asked Questions

Why can't I see my tokens in MetaMask?

If your tokens aren't visible, first ensure you are connected to the correct network they reside on. Then, check if enhanced token detection is enabled. If they still don't appear, try manually adding them using their contract address.

Is it safe to add any token?

No. Only add tokens from projects you trust. Adding a malicious token's contract address can expose you to risks, though simply adding it to your view is generally safe. The real danger comes from approving transactions for malicious smart contracts.

What does hiding a token do?

Hiding a token simply removes it from your main asset view for clarity. It does not affect your balance or remove the tokens from your wallet address. You can always re-add it later using the import function.

Can I add any ERC-20 token?

Yes, MetaMask allows you to add any token that complies with the ERC-20 standard (or equivalent on other networks) by using its correct contract address.

What information do I need to add a custom token?

You need the token's contract address for the specific network it is on. The token symbol and decimals will usually be fetched automatically once the correct address is entered.

The token I added has a balance of zero. Why?

A zero balance means that the contract address you added is correct, but your wallet address does not currently hold a balance of that specific token. Confirm the transaction was successful on a block explorer.