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

Adding a custom token to MetaMask is the process of manually importing a token’s contract address into your wallet so that your balance and transaction history for that asset appear correctly. This is necessary for new or lesser-known tokens that do not show up automatically in your asset list. Here is the direct answer: open MetaMask, copy the token’s contract address from a reliable source like the official project website or a block explorer, click “Import tokens,” paste the address, let MetaMask auto-fill the symbol and decimals, then confirm. The entire process takes less than two minutes, but you must be careful to use the correct network and a verified contract address. ## Why You Need to Import Custom Tokens Manually MetaMask only displays a handful of popular tokens by default. When you receive a token that isn’t on that shortlist, your wallet will show the transaction but not the balance. This doesn’t mean the tokens are lost—they are simply hidden until you tell MetaMask where to look. ### The Role of the Contract Address Every token on a blockchain is defined by a unique string of characters called a contract address. This address is the token’s identity. When you import a custom token, you are essentially giving MetaMask the coordinates to find that token’s ledger on the blockchain. > **Warning:** Never paste a contract address from a random social media post or a direct message. Scammers often create fake tokens with similar names. Always verify the address on the official project website or a trusted block explorer like Etherscan (for Ethereum) or BscScan (for BNB Chain). ## Step-by-Step: Importing a Custom Token The steps below work for the MetaMask browser extension and the mobile app. The interface is slightly different, but the logic is identical. ### Step 1: Select the Correct Network Before importing, ensure you are on the network where the token exists. For example, a token issued on the Polygon network will not appear if you are viewing your Ethereum mainnet balance. - Open MetaMask. - Click the network dropdown at the top of the wallet. - Choose the correct network (e.g., Ethereum Mainnet, BNB Smart Chain, Polygon). If the network is not listed, you will need to add it manually via “Add Network” using the network’s RPC details. ### Step 2: Copy the Token’s Contract Address Go to the official project website or a block explorer and copy the full contract address. It should start with “0x” and be 42 characters long. Do not truncate it. ### Step 3: Open the Import Menu - Click the “Tokens” tab (mobile) or the “Import tokens” link at the bottom of your asset list (extension). - In the extension, you will see a field labeled “Token Contract Address.” ### Step 4: Paste and Auto-Fill Paste the address into the field. MetaMask will automatically detect the token symbol (e.g., USDT) and the number of decimals. Do not change these values unless you know exactly what you are doing—incorrect decimals will display a wildly wrong balance. ### Step 5: Confirm and View Click “Add Custom Token,” then review the details on the next screen. Click “Import” to finish. The token will now appear in your main asset list with your current balance. ## What to Do If the Token Doesn’t Appear Sometimes you import a token, and the balance still shows zero. Here are the most common fixes. ### Check the Transaction Hash Confirm that the transaction that sent you the tokens was actually completed on the same network you are viewing. A transaction on Arbitrum will not show on Ethereum mainnet. ### Verify the Contract Address Again A single wrong character in the address will import a different (often worthless) token. Re-copy the address from the block explorer and try again. ### Use the “Search” Feature on Block Explorers If you are unsure about the contract address, go to a block explorer, search for your wallet address, and look at the “Token Transfers” tab. The token’s contract address will be listed there. Copy it directly from that page. ## Security Best Practices for Custom Token Imports Importing tokens is safe if you follow basic hygiene. The act of importing does not give anyone access to your funds. However, interacting with a malicious token can. ### Never Approve Unknown Contracts If you import a token and then visit a website that asks you to “approve” it for spending, be extremely cautious. Approving a malicious contract can allow the scammer to drain tokens from your wallet. Only approve tokens on sites you trust. ### Use a Dedicated “Burner” Wallet for Testing If you are experimenting with a new token, consider using a separate wallet with a small amount of funds. This is a common practice among advanced users to isolate risk. ### Compare with Trust Wallet’s Approach For context, Trust Wallet (a popular mobile wallet) automatically detects most tokens by scanning the chain, which reduces the need for manual imports. However, Trust Wallet also offers a manual import feature for obscure assets. The key difference is that MetaMask requires you to know the contract address upfront, while Trust Wallet often finds it automatically via its token registry. Both wallets are non-custodial, meaning you control your private keys. The import process in MetaMask is more granular, giving you full control over which assets appear. ## A Quick Reference Table: Extension vs. Mobile | Action | MetaMask Extension | MetaMask Mobile | | --- | --- | --- | | Find import button | Scroll to bottom of asset list | Tap “Tokens” tab, then “Import” | | Paste address | Single field | Single field | | Auto-fill symbol/decimals | Yes | Yes | | Review step | Click “Add Custom Token” then “Import” | Tap “Import” after review | | Network switch | Dropdown at top | Network selector above asset list | ## Final Checklist Before You Import - [ ] You are on the correct network. - [ ] The contract address is copied from a trusted source. - [ ] The symbol and decimals match the official token page. - [ ] You have not approved any unknown contract to spend your tokens. Following these steps will let you manage almost any token inside MetaMask. When in doubt, always double-check the contract address—a small mistake can mean the difference between seeing your real balance and staring at a worthless imposter.