Skip to main content
Aeterna Sol

Crypto markets, protocols and policy

How to Add a Token to MetaMask by Contract Address

To add a custom token to MetaMask using a contract address, select its network, paste the trusted address, review the detected details, and import it.

The Aeterna Sol Editors

How to Add a Token to MetaMask by Contract Address

To add a custom token to MetaMask using its contract address, select the network where it exists, open the custom-token import, paste the address, review the detected details, and import it. The address identifies a token contract on that network, so the selected network must match.

Say you hold a token called PINE on Polygon and want it to appear in MetaMask. You need the PINE contract address for Polygon, not an address you found for another network or a token with the same symbol. If you want to go further on checking a token before a swap, KyberSwap covers token contract verification before swapping.

Why does the network matter?

The network matters because a token contract address identifies a token on a particular network. A token can have different contract addresses on Ethereum, BNB Chain, Polygon, Arbitrum, and Base. MetaMask uses the network you select when it looks up the address and token details.

In the PINE case, the Polygon address is the one to use when MetaMask is set to Polygon. If you select BNB Chain and paste an address from Polygon, MetaMask may not recognize it there or may show details for a different contract. A matching symbol alone cannot tell you that you have the right token: symbols are not unique, and unrelated contracts can use the same one.

Get the address from a trusted project source or the token’s page on the block explorer for the matching network. A block explorer is a site that displays on-chain records, including contract details. Compare the network shown by the source with the network you intend to use in MetaMask, and copy the contract address itself. Do not rely on a search result that gives only a token name or symbol.

MetaMask can detect token details after you paste a contract address, but those details are a prompt to review, not proof that the project is trustworthy. Check that the displayed name and symbol fit the token you meant to add. If the address is unfamiliar or the details do not match your source, stop and recheck the network and address before importing.

How do you import a token on desktop or mobile?

MetaMask’s custom-token flow lets you paste a contract address and import the token into the wallet’s display. The labels can vary slightly by app version, but the task follows the same sequence on desktop and mobile.

  1. Open MetaMask and select the network where the token exists.
  2. Open the token list and choose the option to import or add a custom token.
  3. Paste the contract address from your trusted source or the matching network’s block explorer. Review the detected token details before continuing.
  4. Select Import, then return to the token list and check whether the token and any balance appear.

Use the PINE address from Polygon’s block explorer with Polygon selected in MetaMask. If MetaMask detects the expected details, importing adds PINE to the wallet’s token list. If it does not detect the token or shows unexpected details, confirm that you copied the full address and chose the correct network.

Now change one detail: suppose you want to see PINE on Ethereum instead. The steps still apply, but you must select Ethereum and use PINE’s Ethereum contract address. The Polygon address is not a substitute. Matching the address to the network remains the key check, whether you use MetaMask on desktop or mobile.

If you plan to swap through KyberSwap, make sure MetaMask is set to the same supported network as the token you intend to swap. Adding the token to MetaMask makes it visible in your wallet; it does not make that token available on every network or establish that it is supported by a particular swap route.

Related questions

Does adding a token to MetaMask cost gas?

No. Importing a token changes what MetaMask displays in your wallet; it is not an on-chain transaction, so it does not require a gas fee.

Does importing a token move it into my wallet?

No. Importing only lets MetaMask display tokens already held at your wallet address on the selected network. It does not buy or transfer tokens, create a balance, or verify the project.