How to add a custom token to MetaMask?

"Adding a custom token to MetaMask lets users view and manage tokens not listed by default, requiring accurate contract details to avoid errors or fund loss."

Jul 02, 2025 at 09:01 am

Understanding the Basics of Adding a Custom Token

Adding a custom token to MetaMask allows users to interact with tokens that are not listed by default in the wallet. This is especially useful for those who participate in decentralized finance (DeFi) platforms, NFT marketplaces, or early-stage blockchain projects. Before proceeding, it’s crucial to understand what a custom token is and why you might need to add one manually.

A custom token typically refers to any ERC-20 token on the Ethereum blockchain (or compatible tokens on other networks like Binance Smart Chain or Polygon) that MetaMask doesn’t recognize automatically. You may receive such tokens through airdrops, staking rewards, or participation in decentralized exchanges. Since these tokens aren’t indexed by default, you must input their contract address manually to see your balance in MetaMask.

Gathering Necessary Information

Before adding a custom token, ensure you have all the required details handy. Without accurate information, you risk losing access to your funds or exposing yourself to scams.

You will need:

• Token Contract Address: A unique identifier for the token on the blockchain.
• Token Symbol: Usually a short abbreviation like “DAI” or “USDT.”
• Decimals of Precision: Most tokens use 18 decimals, similar to ETH, but some may differ.
• Token Name (optional): Helpful for identification purposes.
• Network: Confirm which blockchain network the token resides on (e.g., Ethereum Mainnet, Binance Smart Chain).

Make sure the contract address is obtained from a trusted source — preferably directly from the project’s official website or verified smart contract explorer. Copying an incorrect address can lead to irreversible loss of funds.

Navigating Through MetaMask Interface

Once you have the correct token details, proceed to the MetaMask interface. Ensure you’re using the latest version of the browser extension or mobile app to avoid compatibility issues.

In the browser extension:

• Click on the MetaMask icon in your browser toolbar.
• Unlock your wallet if necessary.
• Navigate to the Assets tab located at the top of the wallet interface.
• Scroll down and click on "Import Tokens."

If you're using the mobile version, open the app, tap on the Wallet tab, then scroll down and select "Add Token."

This will bring up a new window where you can either search for a known token or manually enter the details for a custom token.

Entering Token Details Manually

To import a custom token, choose the option to "Custom Token" in the import window. This will prompt you to enter the token details.

• Paste the token contract address into the designated field.
• Wait briefly while MetaMask attempts to fetch the symbol and decimal information automatically.
• If the fields don't auto-fill correctly, manually enter the token symbol and decimals.
• Tap or click "Next," followed by "Add Tokens."

At this point, the token should appear under your Assets list within a few seconds. If it doesn’t show up immediately, try refreshing the page or switching networks and back again.

Always double-check that the contract address matches exactly what was provided by the token issuer. Even a single character difference can result in importing a completely different token or no token at all.

Verifying the Token Balance

After successfully adding the custom token, verify that the correct balance appears in your wallet. If the balance shows as zero, it could mean:

• You imported the token to the wrong account.
• The token hasn’t been sent to your wallet yet.
• There was an error during importation.

To confirm, visit a blockchain explorer like Etherscan for Ethereum-based tokens or BscScan for Binance Smart Chain tokens. Enter your wallet address and check the Token Tracker section to see if the token appears there.

If it does, return to MetaMask and click the refresh button next to your token list. If the balance still doesn’t update, re-import the token carefully, ensuring all details are accurate.

FAQs

Q: What happens if I enter the wrong contract address when adding a custom token?

A: Entering an incorrect contract address may cause MetaMask to display a non-existent token or pull data from another token entirely. Always cross-verify the address from official sources before importing.

Q: Can I remove a custom token from MetaMask once added?

A: Yes. In the Assets tab, locate the token you wish to remove. Click on the three dots beside it and select "Remove." This only removes it from view and doesn’t affect your actual holdings.

Q: Why isn’t my custom token showing a balance after importing?

A: Several reasons could be behind this issue. You may have imported the token to the wrong network, used an incorrect contract address, or the token hasn’t been transferred to your wallet yet. Double-check all details and verify via a blockchain explorer.

Q: Do I need to pay gas fees to add a custom token to MetaMask?

A: No. Adding a custom token is a read-only action and does not require a blockchain transaction. Therefore, no gas fees are incurred during this process.