Troubleshooting MetaMask: Common Errors & Fixes

Try Tangem secure wallet →

Table of contents


Quick checklist: Fast fixes

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

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.


How to access old MetaMask wallet (restore options)

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

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.

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.

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:

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

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)


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:

Who should look elsewhere:

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 →