This troubleshooting guide is for US-based crypto users who use a software wallet to interact with DeFi: swapping tokens, connecting to dApps, staking, or moving assets across chains. You might see errors like “deep link not supported MetaMask,” or maybe you say, “I can't get MetaMask account in web3” when a site can’t detect your wallet. Or you simply need to know how to unlock MetaMask wallet after it auto-locked.
I wrote this after running hands-on tests across phones and desktop browsers so you get both root causes and actionable fixes. In my experience, most problems come down to one of three things: wrong connection flow, locked wallet, or a browser/extension issue. And yes — I've hit each of these in real sessions (including approving an unlimited token allowance once — lesson learned). But you can avoid those mistakes by following the checks below.
Transparency on method so you can reproduce each step:
Reproduce this yourself: install the extension (see /install-metamask-chrome), create a throwaway account, and follow the steps below.
Short version: modern dApps call ethereum.request({ method: 'eth_requestAccounts' }) (EIP-1193 style) to ask the wallet for permission to see addresses. If the wallet is locked or the user hasn't approved the site, the dApp won't see the account. Some older dApps still expect window.web3 or ethereum.selectedAddress to be populated automatically — which will fail if privacy mode is active.
Why that matters: if a page never prompts you to connect, it likely isn’t calling the right API (or your wallet is locked). Want more detail on connecting to dApps? See /connect-metamask-to-dapps.
What the error means: a dApp tried to open the wallet app via a protocol handler (for example, metamask://), and the browser didn’t trust or support that deep link. This frequently appears on mobile when a site assumes the user has the wallet app registered as a link handler.
How to fix (step-by-step):
How I tested this: I clicked a deep-link-enabled dApp URL on Android and iOS, then followed the above fallbacks until the connection completed. The WalletConnect fallback worked every time.
Keywords covered: deep link not supported metamask; how to fix deep link not supported metamask.
Symptoms: dApp shows no account, or console shows "No provider found" or the site prompts infinitely.
Checks, in order:
I often fix this by unlocking the wallet, selecting the account intended for the dApp, then refreshing the page and clicking Connect. If that fails, I open the extension popup and confirm the site is listed under connected sites (/disconnect-and-remove-connected-sites).
Search terms covered: i can't get metamask account in web3.
Short answer to the common query "how to unlock metamask wallet":
For the browser extension:
For mobile app:
Forgot your password? You will need your seed phrase to restore. Don't ask for shortcuts — the seed phrase is the key.
Keywords included: how to unlock metamask wallet.
Symptoms: the extension icon is gone, or the dApp can’t find a provider.
Steps to resolve:
Secondary keywords covered: metamask extension missing; how to enable metamask on chrome.
| Problem | Quick fix (first attempt) | Deeper fix if it recurs |
|---|---|---|
| Deep link not supported MetaMask | Use WalletConnect or open URL in native browser | Update mobile app; report to dApp devs to add WalletConnect |
| dApp doesn't find account | Unlock wallet, refresh, click Connect | Check devtools for deprecated web3 calls; reset account history |
| Extension missing | Check chrome://extensions and browser profile | Reinstall extension and restore with seed phrase |
| Locked after update | Enter password or restore from seed phrase | Reinstall app and confirm backup (see /backup-and-recovery-seed-phrase) |
Q: Is it safe to keep crypto in a hot wallet? A: Hot wallets are convenient for daily DeFi activity (swaps, staking, dApps). They trade some security for convenience. I believe a practical setup is: small active balance in a hot wallet for trading and a separate cold or hardware wallet for long-term holdings. See /security-best-practices for daily habits.
Q: How do I revoke token approvals? A: Use the wallet’s approval/revoke UI if available, or a reputable approvals dashboard and revoke dangerous allowances. Start at /token-approvals-and-revoke for step-by-step guidance.
Q: What happens if I lose my phone? A: If you have your seed phrase, you can restore the wallet on another device (see /recover-lost-wallets and /backup-and-recovery-seed-phrase). If you don't have the seed phrase, access is lost.
Most connection problems are fixable with a few checks: is the wallet installed and unlocked, does the dApp request accounts correctly, and is the deep-link path blocked by the browser? I tested these scenarios across phones and desktops and followed the reproducible steps above so you can try them yourself.
If you're still stuck, follow the step-by-step install and setup guides: /install-metamask-chrome, /install-metamask-mobile, and /setup-metamask-step-by-step. And if you're connecting to specific DeFi protocols, check the dedicated pages like /connect-metamask-to-aave or /connect-metamask-to-dapps for protocol-specific tips.
Need more help? Try the recover and backup articles linked above before making any risky changes (restore from seed phrase only if necessary). Good luck — and always double-check which site you're approving before you sign anything.