MetaMask shows common tokens automatically. But many newer tokens, bridged tokens, or tokens on non-default networks will not appear by name. Adding a token by contract address makes the wallet display balances for that exact token contract. Simple. Useful when you have a custom ERC-20, a bridged token, or stablecoins issued on a non-mainnet chain.
Who this guide is for
If you are totally new to wallets, read the install guides first: install-extension or install-mobile.
Do these checks before you paste any contract address into MetaMask.
In my experience, most mistakes come from being on the wrong network or copying a lookalike address. I learned that the hard way.
[Image: desktop add custom token modal placeholder]
What you will see: a new line in your Assets list with token balance. If it shows 0 but you know you hold tokens, double-check the network and contract address.
You can also paste a contract address you copied on mobile. And in some cases a QR code will be provided by the token issuer to avoid copy errors.
Common causes and quick fixes:
If balances show on a block explorer but not in MetaMask, the issue is almost always network selection or a missing custom token entry. For persistent display problems see not-showing-balance.
Search phrases like 'usdt contract address metamask' or 'usdc contract address metamask' in Google, and you will get multiple results — because these stablecoins exist across many chains. That means the contract address you need depends on the exact network you are using.
How to pick the right one:
Never assume the same address works on every chain. But you already knew that, right? (If not, now you do.)
Can you rename a token? Not directly after it is added. What you can do is remove the token from the wallet display and re-add it as a custom token while editing the Token Symbol field before import. That changes only your local display name — it does not rename anything on-chain.
How to remove a token from MetaMask wallet
Removing or hiding a token only affects the wallet UI. The tokens remain on-chain and are spendable if you interact with their contract.
Adding a token display does not grant approvals. But interacting with dApps often will. Be careful when approving contracts. How do you reduce risk?
I believe the most important habit is verifying contracts before approving any spending allowance. I have had to revoke approvals more than once.
| Method | Ease of adding | Symbol editing | Visibility across devices |
|---|---|---|---|
| Desktop extension | Fast, keyboard paste | Editable when adding | Local to this profile (may need re-add on other device) |
| Mobile app | Fast, copy/paste or QR | Editable when adding | Local to app account (re-add if restoring) |
| WalletConnect session | You add via the connected wallet app | Depends on wallet UI | Same as the wallet you control |
[Image: comparison table placeholder]
Is it safe to keep crypto in a hot wallet?
Hot wallets are convenient. They are not as secure as hardware wallets. If you hold small amounts for DeFi activity, a hot wallet is fine. For large balances, consider a hardware wallet and see hardware-best-practices.
How do I revoke token approvals?
Use a trusted revoke tool or the dApp that issued the approval, or follow the guide at revoke-approvals. Revoke only what you no longer use.
What happens if I lose my phone?
Recover the wallet with your seed phrase on a new install. If you did not back up your seed phrase, funds are likely lost. See backup-and-recovery-options.
Can I add the USDT contract address to MetaMask directly?
Yes, but make sure the address matches the chain you are using. Search for 'usdt contract address metamask' along with your chain name, and then verify the contract on the block explorer.
How do I rename a custom token in MetaMask wallet?
Remove the token display and re-add it as a custom token, editing the Token Symbol field during the add flow.
How do I remove token from MetaMask wallet?
Follow the Remove or Hide token steps above. This only changes the display; it does not burn or move tokens.
Adding a token by contract address is a basic skill for anyone using DeFi. It fixes many of the common issues where balances show on a block explorer but not in your wallet. But do the verification steps first. They prevent the most common scams.
If you want deeper help with tokens and approvals, check the tokens-management guide and the security-best-practices reference. If you need to add a specific network before importing a token, see add-polygon, add-bsc, and add-optimism-arbitrum.
If you found this helpful, follow the step-by-step above next time you encounter a missing token. But always verify the contract address first.