Overview: what "add custom token" means
Adding a custom token in MetaMask means telling your software wallet which token contract to display in your Assets list. The wallet already shows the native coin for the active blockchain (for example, ETH on Ethereum). But many tokens—ERC‑20 tokens, stablecoins, and custom project tokens—are separate smart contracts. If MetaMask doesn't auto-detect one, you import it manually via the contract address so your balance and symbol show up.
Short and practical. Start with the right network.
Can I send USDT to my MetaMask wallet? Yes — but only if you send the version that lives on an EVM‑compatible chain that MetaMask is configured for (for example the ERC‑20 version on Ethereum or a BEP‑20/other EVM equivalent if you’ve added that network). Do not send tokens on non‑EVM chains (like Solana or TRON) to a MetaMask account — that will typically result in lost or hard‑to‑recover funds.
In my experience, the network mismatch is the single biggest cause of confusion.
Before you start: quick safety checklist
- Confirm the token's blockchain (Ethereum, Polygon, BSC, Arbitrum, Optimism, etc.).
- Switch MetaMask to that network first. The token won't appear on the wrong chain.
- Locate the official token contract address from a reliable source (official project site or a reputable block explorer). Don't trust random Forum posts.
- Check token decimals and symbol (these usually auto-fill, but not always).
- Watch out for look‑alike tokens (same symbol, different contract).
And yes, double‑check the contract address before you paste it. Small mistakes can be costly.
Step-by-step: how to add custom token (browser extension)
- Open the MetaMask extension and unlock your account.
- Switch the network to where the token lives (click the network dropdown).
- Click the Assets tab.
- Scroll and click "Import tokens" (usually at the bottom).
- Choose the "Custom Token" tab.
- Paste the token contract address in the "Token Contract Address" field.
- Symbol and decimals often auto-populate. If the fields remain blank, enter the token symbol and decimals manually.
- Click "Add Custom Token" (or "Next"), then click "Import Tokens".
- The token appears in your Assets list with the current on‑chain balance.
Pro tip: if your balance doesn't show immediately, try refreshing the extension, or re‑confirm the network and contract address.
For installation or extension setup instructions, see metamask-extension-installation.
Step-by-step: how to add custom token (mobile app)
- Open MetaMask mobile and unlock.
- Ensure the wallet is set to the correct network (top of the app).
- Tap "Assets" then "+" or "Add token".
- Choose "Custom Token".
- Paste the token contract address. The app should fetch symbol and decimals.
- Tap "Add" (or "Import") to finish.
Mobile often auto-detects tokens faster. I’ve been using mobile daily; the flow is simpler for quick imports.
Token standards and multi-chain considerations: ERC‑20 & more
- ERC‑20: Standard for fungible tokens on Ethereum and EVM‑compatible chains. This is what people usually mean by "tokens."
- ERC‑721 / ERC‑1155: Non‑fungible tokens (NFTs). These are displayed differently and may require the "Collectibles" or NFT view in the wallet (check nft-overview).
- SPL / non‑EVM tokens: Tokens on Solana, Tron, or other non‑EVM chains will not appear in MetaMask because MetaMask is for EVM‑compatible networks unless you use a bridge or a wallet that supports those chains.
Think of each blockchain like a postal system with different zip codes. Sending a package to the wrong zip code means someone else gets it, or it never arrives.
If you hold USDT: which version did you withdraw from an exchange? If that withdrawal used an EVM network that MetaMask supports and you add that network and the token contract, you can receive it. If the exchange sent a TRON TRC‑20 or Solana SPL version, MetaMask won't accept it directly.
For more on network options, see network-switching-multi-chain and layer2-and-transfers.
Common issues and troubleshooting
- "Token not showing": usually the wrong network or wrong contract address.
- "Zero balance shown": token may have non‑standard decimals; confirm decimals on a block explorer.
- "I see a token but can't send it": some tokens are locked by smart contract rules or require a specific gateway. Check the token's docs.
- Duplicate tokens (same symbol): compare contract addresses to identify the real one.
But remember: if you mistakenly sent tokens on the wrong blockchain and they are non‑EVM (or to a different address format), recovery is often difficult and may require support from the sending platform.
If you need step‑by‑step transfer help, see transfer-what-can-you-send-to-metamask and receive-crypto.
Security tips and housekeeping
- Always verify the contract address on an authoritative source. (A project's official site or a verified block explorer listing.)
- If you interact with dApps, watch token approvals. I once granted an unlimited allowance by mistake and had to revoke it. Use revoke-approvals to clean permissions.
- Hide spam tokens using hide-spam-tokens if your asset list gets noisy.
- For larger balances, integrate a hardware wallet; MetaMask supports hardware keys — see ledger-and-hardware.
- Backup your seed phrase and store it offline. Never share private keys.
What I've found: frequent tidy‑ups (revoke approvals, hide spam) keeps the wallet usable and safer.
Who MetaMask suits — and who should look elsewhere
Who it's for:
- Users who interact with DeFi on EVM‑compatible chains and dApps via the browser or mobile.
- People who want quick swaps, token imports, and WalletConnect support.
Who should look elsewhere:
- Users who need native Solana or TRON token support (consider a wallet that natively supports those chains).
- People requiring custody with a third party; MetaMask is a non‑custodial software wallet, so you keep your private keys.
If you need hardware-level security for daily DeFi, combine both: use MetaMask for convenience and a hardware wallet for large holdings.
FAQ
Q: Is it safe to keep crypto in a hot wallet?
A: Hot wallets are convenient for daily use. They are software wallets holding private keys on an internet-connected device, so they carry more risk than cold storage. For small, active amounts they make sense. For large holdings, I recommend a hardware wallet paired with this software wallet (see ledger-and-hardware).
Q: How do I revoke token approvals?
A: Use a permission/revoke tool or MetaMask's approval management UI to revoke allowances per contract. See revoke-approvals for step‑by‑step tools and safety tips.
Q: What happens if I lose my phone?
A: If you backed up your seed phrase, you can restore your account on a new device. If you didn't, access is lost. See seed-phrase-backup-and-recovery and lost-phone for recovery workflows.
Q: can i send usdt to my metamask wallet?
A: Short answer: Yes — but only the USDT token version that lives on an EVM‑compatible network that MetaMask is set to. Always confirm the network and contract address before sending.
Conclusion and next steps
Adding a custom token to MetaMask is a small task with big practical benefits: you see balances, track portfolio entries, and interact with tokens in DeFi. Follow the safety checklist, confirm the network and the contract address, and use the import flow on extension or mobile.
If you want more hands‑on walkthroughs, check the metamask-mobile-guide or the metamask-extension-installation pages. Need help moving tokens or checking networks? See transfer-what-can-you-send-to-metamask and network-switching-multi-chain.
Ready to add a token? Take a deep breath, verify the contract, and paste it into the Custom Token field — then confirm. Good luck, and keep your seed phrase offline.
Table: Quick comparison — extension vs mobile
| Feature |
Browser extension |
Mobile app |
| Add custom token |
Import tokens → Custom Token |
Assets → + → Custom Token |
| Ease of use |
Good for desktop dApp flows |
Faster for on‑the‑go imports |
| NFT view |
Limited (depends on version) |
Built‑in collectibles view |
| WalletConnect |
Used from dApp sites |
Built‑in Scanner |
(Images above are placeholders.)
