How to add custom tokens in MetaMask? What if the balance is not displayed after adding?

Adding custom tokens to MetaMask requires the token's contract address, symbol, and decimals; ensure accuracy to avoid balance display issues.

May 09, 2025 at 10:28 am

Adding custom tokens to your MetaMask wallet can be an essential skill for managing your cryptocurrency portfolio, especially if you're dealing with tokens that are not listed by default in the MetaMask interface. In this article, we'll guide you through the process of adding custom tokens to your MetaMask wallet and troubleshoot the common issue of the balance not displaying after adding the token.

Understanding Custom Tokens in MetaMask

Before we delve into the steps of adding custom tokens, it's important to understand what custom tokens are. Custom tokens are cryptocurrencies that are not automatically recognized by MetaMask. These could be new tokens, tokens from less popular blockchains, or tokens that have not yet been added to MetaMask's default list. To add them, you need to manually input the token's contract address, symbol, and decimals.

Preparing to Add Custom Tokens

To successfully add a custom token, you'll need three pieces of information:

• Contract Address: This is the unique identifier for the token on the blockchain.
• Token Symbol: The shorthand representation of the token, such as ETH for Ethereum.
• Decimals: The number of decimal places the token uses, which determines the smallest unit of the token.

You can usually find these details on the token's official website, its listing on a blockchain explorer, or through the token's smart contract documentation.

Steps to Add Custom Tokens in MetaMask

Here's how you can add a custom token to your MetaMask wallet:

• Open MetaMask: Launch the MetaMask extension or mobile app and ensure you're logged into your wallet.
• Navigate to the Assets Tab: Click on the "Assets" tab to see your current list of tokens.
• Add Token: Click on the "Add Token" button. You will be taken to a new screen where you can add tokens manually.
• Enter Token Details: Select "Custom Token" and enter the Contract Address, Token Symbol, and Decimals of the token you want to add.
• Import Token: After entering the details, MetaMask will automatically detect if the token is valid. If it is, you'll see the token's logo and balance. Click on "Next" and then "Add Tokens" to complete the process.

The token should now appear in your list of assets, and you should be able to see its balance.

Troubleshooting: Balance Not Displayed After Adding Token

If you've added a custom token to MetaMask but the balance is not displaying, there are several steps you can take to troubleshoot the issue:

• Check Network: Ensure you are on the correct network. If the token is on a different network (like BSC or Polygon), you need to switch to that network in MetaMask.
• Verify Contract Address: Double-check the contract address you entered. A single incorrect character can result in the token not being recognized.
• Refresh MetaMask: Sometimes, simply refreshing the wallet can resolve the issue. Click on the three dots at the top right of the MetaMask window and select "Refresh".
• Check Token Decimals: Ensure the number of decimals you entered matches the token's actual decimals. Incorrect decimals can cause the balance to not display correctly.
• Blockchain Explorer: Use a blockchain explorer like Etherscan to verify the token's details and check if your wallet address holds the token.

Additional Considerations When Adding Custom Tokens

When adding custom tokens, it's crucial to be cautious. Since you're manually entering information, there's a risk of entering incorrect data or falling victim to scams. Always verify the token details from reputable sources before adding them to your wallet.

Ensuring Token Visibility and Functionality

After adding a token and ensuring its balance is visible, you might want to check if the token functions correctly within MetaMask. You can do this by attempting to send and receive the token. If the token supports additional functionalities like staking or governance, you might need to interact with the token's smart contract directly or use a decentralized application (dApp) that supports these features.

FAQ

Q1: Can I add custom tokens from any blockchain to MetaMask?

A1: MetaMask primarily supports Ethereum and Ethereum-compatible blockchains like Binance Smart Chain and Polygon. If the token you want to add is on one of these networks, you can add it to MetaMask. For tokens on other blockchains, you might need to use a different wallet that supports those networks.

Q2: What should I do if MetaMask doesn't recognize the token after entering the correct details?

A2: If MetaMask doesn't recognize the token despite entering the correct details, it could be due to a temporary issue with the network or MetaMask itself. Try switching to a different network and back, or restart your browser or device. If the problem persists, you might need to wait a bit and try again later.

Q3: Can I remove a custom token from my MetaMask wallet?

A3: Yes, you can remove a custom token from your MetaMask wallet. Go to the "Assets" tab, find the token you want to remove, click on the three dots next to it, and select "Hide". This will remove the token from your list of assets, but it won't affect your actual balance of the token on the blockchain.

Q4: Is it safe to add custom tokens to my MetaMask wallet?

A4: Adding custom tokens can be safe if you're careful about verifying the token's details from trusted sources. However, there's always a risk of scams or entering incorrect information. Always double-check the contract address and other details before adding a token to ensure you're adding the correct token.