Before we get into the practical steps of adding or managing tokens in MetaMask, it’s worth clarifying what “tokens” actually are in this context. MetaMask primarily interacts with Ethereum-based assets — like ERC-20 tokens — which represent a wide range of cryptocurrencies and digital assets beyond just Ether (ETH). This includes stablecoins, DeFi tokens, and sometimes NFTs (though these use different standards).
MetaMask's default setup often shows popular assets automatically. However, many tokens require manual addition, especially if they’re newer or on a custom network. This is where knowing how to add a custom token or contract address becomes necessary for visibility and management.
MetaMask doesn't control your tokens — it simply provides a non-custodial interface to view and interact with your blockchain assets. The actual private keys remain secure by design, but token visibility depends on wallet configuration.
Adding a custom token in MetaMask can seem tricky, but it’s really a straightforward process once you understand the required info. Here’s a step-by-step guide from my experience and testing:
And voilà, the new token appears in your wallet balance. Adding custom tokens this way is common for assets not in MetaMask’s default registry or on lesser-known blockchains.
For a visual step-by-step setup, check our add-custom-token-to-metamask internal guide.
To clarify, adding a contract address is the same as adding a custom token in the wallet context. The contract address uniquely identifies the token on the blockchain. But why does this matter?
Think about it this way: your MetaMask wallet tracks balances by checking the blockchain for token balances linked to your wallet address. Without the contract address, MetaMask doesn't know which token data to display. This is especially relevant for new or niche tokens.
Be cautious about sourcing contract addresses. Use reputable blockchain explorers like Etherscan or verified project websites. Entering incorrect addresses or counterfeit contracts is a common user error that can lead to confusion or outright scams.
If you want more on using Etherscan with MetaMask to verify tokens, we have a detailed piece on that.
Many users ask how to add well-known tokens like BUSD, CAKE, or native ETH to their MetaMask wallet. Here’s what I found:
This network-switching aspect trips up many newcomers — MetaMask separates tokens by blockchain networks, so you’ll only see tokens on the active network. For guides on adding networks like Binance Smart Chain or Polygon, visit our add-bsc-to-metamask and add-polygon-to-metamask pages.
Ever seen weird tokens or spam NFTs show up in your MetaMask? This happens due to token airdrops or wallet interactions with unknown contracts.
MetaMask allows you to hide such tokens, which removes them from the visible dashboard without deleting them from the blockchain.
Steps to hide a token:
This action tidies your wallet without affecting your actual holdings. If you want to restore a hidden token, you can do so from the “Hidden tokens” section.
To hide spam NFTs specifically, see our hide spam nft metamask guide for recommended practices.
This is a common question: can you permanently delete a token from MetaMask?
The key point — tokens exist on the blockchain, not inside MetaMask. So you cannot erase them from the blockchain or your wallet’s on-chain holdings. But you can remove the token's visibility and transaction history within MetaMask.
Here’s the procedure:
Remember, this doesn’t send or burn your tokens; it just cleans up your interface.
Check our reset-delete-and-reinstall article for detailed instructions and precautions.
Knowing how to inspect a token or its underlying contract on MetaMask adds a layer of safety.
MetaMask doesn’t natively display detailed contract info but integrates well with third-party blockchain explorers. If you suspect a token or receive an unexpected contract interaction, copy the contract address and search it on explorers like Etherscan where you’ll find:
Inspecting tokens helps avoid scams or phishing attempts where malicious contracts mimic legitimate tokens.
For more proactive security, our phishing-address-poisoning and security-checklist pages offer comprehensive advice.
Managing tokens through custom contract addresses carries inherent risks:
In my experience, users who regularly check token allowances and revoke unnecessary approvals reduce exposure to rogue smart contracts. For a step-by-step on revoking token permissions, visit our token-allowances-and-revoke guide.
MetaMask’s flexibility in adding, hiding, and inspecting tokens makes it a versatile wallet for managing various crypto assets but requires attentiveness.
I believe understanding these processes empowers anyone to use MetaMask confidently without falling prey to common pitfalls.
For more beginner-friendly instructions on MetaMask setup and security, don’t miss our getting-started-metamask and security-checklist pages.
Ready to optimize your MetaMask token experience? Start by adding a custom token or contract you’re interested in today, armed with these guidelines to keep things secure and tidy.
Explore other MetaMask topics: connect hardware wallets with MetaMask, manage multisig setups, or understand gas fees for smoother transactions.