How to Add a Custom Token to MetaMask: Step-by-Step Guide

Article Summary

• This article provides a direct, easy-to-follow, step-by-step guide on how to manually add a custom token to a MetaMask wallet.
• It addresses a very common problem for new users: they have received a token, can see it on a block explorer, but it doesn't appear in their MetaMask asset list.
• The guide explains that MetaMask only displays popular, pre-loaded tokens by default and that most other tokens need to be added manually.
• It walks the user through the two main methods: the Automatic Method (using a token tracking site like CoinGecko) and the Manual Method (finding the token's contract address on a block explorer and pasting it into MetaMask).
• The article is heavily reliant on clear screenshots for each step of the process to ensure it is foolproof for beginners.

You bought a token, claimed an airdrop, or received a transfer from a friend. The block explorer says the transaction succeeded. Then you open MetaMask and see nothing. That empty balance can feel like a trap door opened under your feet, but the tokens usually are not gone.

If you bought the token on a crypto exchange like Bitunix, you might have withdrawn it to MetaMask to use it in DeFi or to hold it in self-custody.

Here is what is happening. Your assets live on the blockchain, not inside the wallet app. MetaMask just decides what to display. It automatically shows many popular assets, but it cannot keep up with every new token on every network.

This guide will show you two simple, quick methods to add any custom token to your MetaMask wallet so you can see and manage your assets.

Before You Begin — Find Your Token's Contract Address

The key ingredient is the token's contract address. Think of it as the token's unique identifier on that network. If you paste the right address, MetaMask can display the token you already own. MetaMask's help docs describe token addresses as the way you interact with a specific ERC-20 token on a network, similar to how you use a public address to receive funds.

If MetaMask not showing the token is your problem, do two quick checks first. Confirm the transaction finished, and confirm you are on the right network.

The Automatic Method (The Easiest Way)

Before you copy anything, pause for ten seconds and decide where you will source the contract address. There are two reliable paths: a token information site that aggregates verified metadata or the chain's own block explorer that shows the contract directly on-chain.

Method A: Use a Token Information Site (Recommended for Beginners)

Start with CoinGecko, since many token pages display contract addresses clearly and often include a MetaMask integration button. MetaMask's help docs list CoinGecko as a standard place to locate contract addresses and show examples of where the contract section appears.

What you are looking for is a "Contract" field with an address you can copy. On some pages, you will also see a small MetaMask fox icon next to the address, which can trigger the automatic add-token prompt.

Method B: Use a Block Explorer (Best for Verification)

If you want to verify the token directly on-chain, use the block explorer for the network where the token was sent. Examples include Etherscan for Ethereum and BscScan for BNB Smart Chain. Explorers clearly label the contract address on a token page, and most major explorers look similar.

Also, if your priority is to double-check the transfer, use a block explorer to find the transaction by your transaction hash and confirm that the "To" address matches your wallet.

Crucial Warning: Only Copy Addresses From Trusted Sources

In 2025, Chainalysis estimated $17B was stolen in crypto scams and fraud, and it reported huge growth in impersonation-driven scams. That same year, MetaMask highlighted research suggesting nearly 90% of tokens launched on Uniswap v2 pools on Base over a 28-day window were hard rug pulls, with one actor linked to over 19,000 scam tokens.

So treat contract addresses like you treat bank details. If a random DM gives you an address, ignore it. If a block explorer page shows a weird error message telling you to visit a site, do not click.

The Automatic Method (The Easiest Way)

If you are learning how to add a custom token to MetaMask, this is the easiest path. It uses the built-in connection between MetaMask and token listing sites, so you do not need to paste anything manually. MetaMask explicitly recommends this approach through CoinGecko or CoinMarketCap when the integration button appears.

Step by Step

1. Go to the token’s page on CoinGecko (or CoinMarketCap).
2. Find the Contract section and make sure you are viewing the right network.
3. Click the MetaMask fox icon next to the contract address.
4. MetaMask opens a prompt asking permission to add the suggested token. Confirm.
5. Return to your asset list. The token now appears, assuming you hold it on that network.

Mobile note: MetaMask says this one-click method works on mobile when you open the listing site inside the MetaMask in-app browser, not your normal phone browser.

How to Add a Custom Token to MetaMask (The Manual Method)

Sometimes the fox icon is missing. Sometimes the token is brand new. Sometimes you want the universal method that works even when the listing sites lag behind. This is where you import the token MetaMask style, using the contract address you verified.

You can also use this method when you want to add an ERC-20 token to MetaMask on a specific network, and you already know the correct contract. Just remember that a token deployed on Ethereum and the same token bridged to another chain can have different contract addresses per chain.

Step by step

1. Open your MetaMask wallet.

2. Select the correct network at the top. If you stay on the wrong network, the token will not show, even if the transfer succeeded.

3. Scroll to the bottom of your token list and click Import tokens (or the + button on mobile).

4. Paste the token contract address into the Token contract address field.

5. MetaMask fills in the token symbol and decimals when you paste a valid address. If those fields do not populate, stop and re-check the address and the network.

6. Click Next, then Import to add it to your assets list.

If you want extra certainty, compare the contract address on CoinGecko with the one on the block explorer.

Conclusion: You Are in Control

Your tokens are never stored inside MetaMask. They remain on-chain, and MetaMask shows them based on token detection or the addresses you add. MetaMask even says token detection relies on community token lists and encourages caution with unfamiliar tokens.

Once you learn how to add a custom token to MetaMask, you stop treating the wallet like a black box and start treating it like a dashboard you control. That skill helps every time you explore new protocols, claim rewards, or test a new chain.

And when you download the app,register, and buy tokens on Bitunix and withdraw to a self-custody DeFi wallet, this is the exact move that prevents the classic panic moment. Use the steps above, verify the contract address, and keep your security habits tight.

FAQ

What if the token symbol and decimal don't auto-fill?

That usually means you pasted an invalid contract address or you selected the wrong network. Re-copy the address from a trusted listing page or explorer, then confirm you are importing on the same chain where the token was received. If it still fails, stop and verify the token is real.

I added the token, but my balance is still zero. Why?

Most of the time, you are viewing the wrong network, or the transfer went to a different address. Check the transaction hash on the correct explorer, confirm the recipient address matches your MetaMask account, and confirm the token contract matches the one you imported.

How do I add a token on a different network, like Polygon or Avalanche?

Switch MetaMask to that network first, then import the token using the contract address deployed on that network. The same token can have different contract addresses across chains. MetaMask also supports adding tokens via listing sites, where you can select the network next to the contract entry.

How do I remove a token from my MetaMask list?

Open the token in your MetaMask token list and use the Hide option, or long-press the token on mobile and select Hide. This only removes it from your display. It does not affect the token on-chain, and it does not change your actual balance.

Is it safe to add any custom token?

Adding a token to your display is generally safe, but interacting with unknown tokens and links is risky. Scammers often use fake tokens and misleading block explorer messages to push you to phishing sites or dangerous approvals. Only use contract addresses from trusted sources and ignore random airdrops you did not expect.

Why do some tokens appear automatically?

MetaMask uses token detection for popular tokens and, on supported networks, enhanced token detection that draws from community token lists. If you are a new user, it can be enabled by default, and you can also toggle autodetect in settings. Automatic detection varies by network and token list coverage.

Can I do this on the MetaMask mobile app?

Yes. The steps are the same, but the buttons look slightly different. MetaMask also recommends using the in-app browser on mobile when you want to use CoinGecko or CoinMarketCap for one-click token adding. For manual import, tap the + button and paste the contract address.

What is a token decimal?

Token decimals define how many smaller units make up one whole token, similar to cents in a dollar. Thesmart contract sets this value. MetaMask shows balances using decimals, so you see a human-readable number instead of a large integer. Most tokens use 18 decimals, but not all do.

I can't find my token on CoinGecko or a block explorer. What do I do?

First, verify you have a real transaction hash and that the transfer actually happened. If you cannot locate the token on a reputable explorer for that chain, treat it as suspicious. Do not use random contract addresses from social media. Ask the sender for the official contract and verify it independently.

Does adding a token cost any gas fees?

No. Adding or hiding a token only changes what MetaMask displays. You do not broadcast a blockchain transaction, so you pay no gas. You only pay gas when you send tokens, swap, approve spending, or interact with a smart contract on-chain.

Glossary

• Contract address — The unique on-chain address of a token's smart contract on a specific network.
• Token detection — A wallet feature that automatically displays tokens based on curated or community token lists.
• Enhanced token detection — MetaMask's expanded auto-display feature on selected networks beyond Ethereum mainnet.
• Block explorer — A website that lets you search transactions, addresses, and token contracts on a blockchain.
• Transaction hash — A unique identifier you use to look up a specific transfer or contract interaction.
• Network — The blockchain you are connected to in MetaMask, like Ethereum, Polygon, or Avalanche.
• EVM network — A chain compatible with the Ethereum Virtual Machine and common Ethereum tooling.
• Token symbol — The short ticker used to label a token in wallets, like UNI or USDC.
• Token decimals — The precision setting that defines a token's smallest unit and how balances display.
• Airdrop — A token distribution method that can be legitimate or used as a scam lure.
• Phishing — Social engineering that tricks you into sharing keys, signing approvals, or visiting malicious sites.
• Token approval — A permission you sign that allows a contract to spend your tokens, often exploited in scams.
• Self-custody wallet — A wallet where you control the keys, and you hold full responsibility for security.
• Token listing site — A directory like CoinGecko that shows token info, contract addresses, and networks.
• Smart contract — On-chain code that defines token behavior, balances, and rules for transfers and approvals.

About Bitunix

Bitunix is a global cryptocurrency derivatives exchange trusted by over 5 million users across more than 100 countries. The platform is committed to providing a transparent, compliant, and secure trading environment for every user. Bitunix offers a fast registration process and a user-friendly verification system supported by mandatory KYC to ensure safety and compliance. With global standards of protection through Proof of Reserves (POR) and the Bitunix Care Fund, Bitunix prioritizes user trust and fund security. The K-Line Ultra chart system delivers a seamless trading experience for both beginners and advanced traders, while leverage of up to 200x and deep liquidity make Bitunix one of the most dynamic platforms in the market.

Bitunix Global Accounts

X | Telegram Announcements | Telegram Global | CoinMarketCap | Instagram | Facebook | LinkedIn | Reddit | Medium

Disclaimer: Trading digital assets involves risk and may result in the loss of capital. Always do your own research. Terms, conditions, and regional restrictions may apply.