How to fix MetaMask not showing token balance? (Troubleshooting)

Understanding Token Balance Visibility Issues

1. MetaMask relies on external blockchain nodes to fetch token balances, and if the selected network RPC endpoint is unresponsive or misconfigured, token balances may not appear.

2. Custom token contracts must be verified on Etherscan or equivalent explorers; unverified contracts often result in zero or missing balance displays despite on-chain holdings.

3. The wallet address used in MetaMask might differ from the one holding tokens due to incorrect account switching—users sometimes overlook active account selection in the top-right corner.

4. Token standards matter: ERC-20 tokens require proper contract address, symbol, and decimal inputs during manual addition, while ERC-721 or ERC-1155 assets won’t show as balances in the main asset list unless explicitly supported by the interface version.

5. Browser extension conflicts—especially with ad blockers, privacy tools, or other Web3 injectors—can suppress balance rendering by interfering with MetaMask’s content script execution.

Verifying Network Configuration

1. Confirm that MetaMask is connected to the correct network where the token resides—for example, a BSC-based BEP-20 token will not display on Ethereum Mainnet.

2. Check whether the custom RPC URL includes a valid API key for services like Infura or Alchemy; expired or rate-limited keys return empty responses silently.

3. Switching between networks triggers cache invalidation—forcing a manual refresh (Ctrl+R or Cmd+R) after network change often resolves stale balance states.

4. Some testnets have inconsistent archival node support; using a public endpoint like Chainstack or QuickNode improves reliability over default MetaMask-provided URLs.

5. If using a local node like Geth or Hardhat, ensure the node exposes eth_getBalance and eth_call endpoints—and that CORS headers permit requests from localhost:3000 or similar origins.

Token Addition and Contract Validation

1. Manually adding a token requires exact contract address matching—case sensitivity matters, though MetaMask normalizes checksums automatically upon paste.

2. Tokens deployed via proxy patterns (e.g., Transparent Proxy or UUPS) may expose implementation addresses instead of proxy addresses; querying the proxy’s implementation slot yields the true contract location.

3. A token’s totalSupply must be non-zero and its transfer function accessible; contracts with paused transfers or blacklisted owners may report balances but hide them in UI layers.

4. Decimal precision mismatches between on-chain storage and MetaMask input cause display anomalies—e.g., entering 18 decimals for a token with only 9 on-chain results in balance division by 1 billion.

5. MetaMask caches token metadata from community-sourced lists like the Token Lists project; outdated or missing entries force reliance on manual contract interaction, which lacks auto-balancing logic.

Browser and Extension Environment Checks

1. Disable all non-MetaMask extensions temporarily—particularly those injecting scripts into dApp pages such as Phantom, Coinbase Wallet, or Rainbow.

2. Clear MetaMask’s internal cache by navigating to Settings > Advanced > Reset Account; this forces re-fetching of balances without removing seed phrases or accounts.

3. Ensure the browser allows third-party cookies and site data; blocking these prevents MetaMask from storing session keys needed for token balance polling.

4. Try accessing the same dApp in an incognito window with only MetaMask enabled—this eliminates interference from saved logins, cached JS bundles, or service workers.

5. On mobile, verify that the MetaMask Mobile app uses the same network and account as the browser extension—cross-device sync does not extend to token visibility settings.

Frequently Asked Questions

Q: Why does my token show 0.000000 even though Etherscan confirms I hold it?A: This usually indicates a decimal mismatch or incorrect contract address entry—re-add the token using verified details from Etherscan’s contract page.

Q: Can MetaMask display tokens from multiple chains simultaneously in one view?A: No. MetaMask shows balances only for the currently selected network. Users must switch networks manually to see corresponding tokens.

Q: Does resetting my MetaMask account delete my private keys?A: No. Resetting the account clears cached balances and transaction history but retains your seed phrase and wallet access intact.

Q: Why do some tokens appear under “Collectibles” but not “Assets”?A: Collectibles represent NFTs (ERC-721/ERC-1155), which are tracked separately from fungible token balances and require different detection logic within MetaMask’s interface.