Independent review. This site is not the official website and is not affiliated with, endorsed by, or operated by the wallet vendor reviewed here. Never enter your seed phrase or private keys on any third-party site.

Troubleshooting MetaMask: Common Errors & Fixes

Try Tangem secure wallet →

Quick checklist: Fast fixes

Before a deep fix, run this 30-second checklist. It solves a large share of problems.

  • Are you on the correct network (Ethereum mainnet, Polygon, BSC, etc.)? Switch networks and re-check.
  • Is your account locked? Enter your password or restore with your seed phrase if you forgot it.
  • Did you add a custom token? If not, add the contract address manually (Add custom token).
  • Does the block explorer show the funds for your address? If yes, the issue is UI-related.
  • Try a browser refresh, extension restart, or mobile app force-close. Small steps first.

And yes, these quick checks save time. I've used them dozens of times.


How to unlock my MetaMask wallet (step-by-step)

If the extension or app shows a lock screen, follow these steps.

  1. Open the MetaMask extension or mobile app.
  2. Enter your password. Short password typos are the most common cause of a locked wallet.
  3. If you forgot the password: restore the wallet using your seed phrase. Go to the wallet setup flow and pick "Import using seed phrase." See Seed phrase backup & recovery for secure steps.
  4. If the extension is corrupted after an update, try disabling and re-enabling the extension, or uninstall and reinstall then restore with your seed phrase (Reset, delete, and reinstall).

If you're asking specifically how to unlock my metamask wallet for a dApp session (such as an injected provider), make sure the site requested connection and that you approved the connecting account.

Try Tangem secure wallet →

How to access old MetaMask wallet (restore options)

Want to access an old wallet created years ago? You have three non-destructive options.

  • Restore with seed phrase: The standard and safest method if you control the original seed phrase. Follow the import flow and recreate all accounts derived from that phrase. See Import and restore wallet.
  • Import a private key: Use this for a single account exported from an old setup. This adds a single account — it does not recreate hierarchical accounts.
  • Import JSON (encrypted) file: Only use if you have the secure JSON file and its password.

If you do not have the seed phrase or private key, there is no reliable way to recover access. In my experience this is the hardest lesson: always back up your seed phrase offline and test recovery once.


MetaMask not showing balance — causes & fixes

Why does MetaMask not show balance? Common root causes and how to fix them.

  • Wrong network selected: Your funds may be on Ethereum mainnet but the wallet is set to an L2 or testnet. Switch the network (top of extension/mobile). See Add L2 networks and custom RPC settings.
  • Token not added to the UI: Add the token manually with the token contract address (Add custom token).
  • RPC node lag or outage: Switch to a different RPC provider or try again later. Some custom RPCs fall behind block height.
  • Sent to another chain: If you sent an ERC-20 to a BSC address, the token will appear on the other chain. Check block explorers for both chains.

If the block explorer shows your funds at your address but the UI does not, it's a UI issue — adding the token or switching networks fixes it 90% of the time. But sometimes the extension cache needs a reset (Reset, delete, and reinstall).


Fix MetaMask pending transactions (speed up, cancel, reset)

A stuck transaction is frustrating. Here's how to unstick it.

  • Use Speed Up: MetaMask re-broadcasts the same transaction with a higher priority fee. This is usually effective when you increase the priority fee by 2x–3x relative to the previous setting (network-dependent).
  • Use Cancel: MetaMask can send a replacement transaction with the same nonce and 0 ETH to yourself; cancel succeeds if miners include that higher-fee replacement.
  • Manual replacement: Enable custom nonce in Settings → Advanced, then send a 0 ETH tx to your own address using the stuck tx nonce and higher gas.
  • Reset account: This clears the local pending transaction list but does NOT cancel on-chain transactions. Use this only if you want to clear stuck UI state (pending transaction troubleshooting).

But remember: a reset does not remove the transaction from the blockchain. It just clears the local metadata. If you need a guaranteed cancellation, replace the nonce on-chain with a higher-fee tx.


How to validate my MetaMask wallet (authenticity & ownership)

Two validation types matter: is the app/extension authentic, and do you control the address?

To validate the extension/app:

  • Install from official browser/app stores and verify the publisher name carefully.
  • Check extension ID or app publisher against the official project website when possible.
  • Review requested permissions before approving an update.

To validate ownership of an address (proof of control):

  • Use a safe signing flow to sign a short, explicit message and verify it on a reputable verifier or block explorer feature. Only sign messages you understand. (Signing arbitrary messages can risk exposing account control if the message asks to approve transactions.)
  • Alternatively, copy your public address and confirm the same address on a block explorer.

If you suspect a fake extension or rogue build, do not enter your seed phrase. Move to a secure device and follow compromised wallet—what to do.


Unlock MetaMask for CryptoKitties and other dApps

If a dApp (e.g., CryptoKitties) won't connect:

  1. Ensure the dApp runs on the network your account uses (most games use Ethereum mainnet). See metamask-mobile-ios-android for mobile dApp browser tips.
  2. Click the site’s "Connect" button. Approve the connection in the MetaMask popup.
  3. If nothing happens, disable popup blockers and confirm the extension is enabled for that site.
  4. On mobile, use the in-app browser or WalletConnect if the dApp supports it (WalletConnect guide).

If the dApp still fails, check the browser console for errors (developers only) or try another browser profile to rule out extensions conflicts.


Common errors quick reference (table)

Symptom Likely cause Quick fix
Locked wallet / forgotten password Password lost Restore with seed phrase (seed-phrase-backup-recovery)
No token balance showing Wrong network or token not added Switch network or add token (add-custom-token)
Stuck transaction Low gas / mempool congestion Speed up / replace tx or reset account (pending-transaction-troubleshooting)
dApp won't connect Blocked popup or wrong network Enable extension, allow site, use WalletConnect (walletconnect-guide)

placeholder: screenshot of MetaMask account screen


Security reminders, real mistakes, and who this wallet is for

In my experience I've approved an allowance I shouldn't have and had to revoke it later (link: token allowances & revoke). I also once sent tokens to the wrong chain and had to use a cross-chain bridge recovery process. These are preventable with simple checks.

Who this software wallet is best for:

  • Users who need quick access to DeFi, swaps, and dApps across EVM-compatible chains.
  • People who value UX and frequent on-chain interaction on mobile and desktop.

Who should look elsewhere:

  • Users who prioritize maximum security over convenience; consider hardware wallets or advanced smart-contract wallets (see hardware-wallets).

But also remember: hot wallets are a trade-off between convenience and custody. Think through your risk model.


FAQ

Q: Is it safe to keep crypto in a hot wallet?

A: Hot wallets are convenient but not as secure as cold storage. Use them for active funds, and keep large amounts offline in hardware wallets. See security checklist.

Q: How do I revoke token approvals?

A: Use the token approvals UI in MetaMask or an on-chain revocation tool, then confirm the revocation. Follow token-allowances-and-revoke for step-by-step instructions.

Q: What happens if I lose my phone?

A: Restore the wallet on a new device using your seed phrase. If you used cloud backups or social recovery, understand the risk trade-offs—read seed-phrase-backup-recovery.


Conclusion & next steps (CTA)

If you followed these steps and still have trouble, start by restoring from your seed phrase on a secure device and then review your pending transactions and token approvals. For step-by-step walkthroughs, see: Import and restore wallet, Pending transaction troubleshooting, and Seed phrase backup & recovery.

In my experience, a careful, measured approach solves most MetaMask issues without panic. But if you think your keys are compromised, act fast and follow the compromised wallet guide above. Good luck — and keep backups safe.

Try Tangem secure wallet →