Quick summary: who this guide is for
If you're using MetaMask (the hot software wallet) to interact with DeFi, swaps, dApps or Layer 2s, this page is a practical trouble‑shooting checklist. I use the extension and mobile app daily and have run into most of these faults — yes, even the dumb mistakes that cost time and a few cents in gas.
Who this guide is for
- Daily traders and DeFi users who need quick reconnection and signing fixes.
- Developers or power users who hit provider-detection edge cases. (See developer-integration.)
Who should look elsewhere
Common connection errors — what they mean
Short list first, then how to fix them. These are the exact messages people see and the typical root cause.
- "not connected metamask" — dApp can't see an unlocked account or connection was never authorized.
- "please unlock account in metamask" — wallet is locked (password-protected app or extension). Unlock then reconnect.
- "no keyring found for the requested account metamask" — the requested address isn't present in the wallet's active keyrings (hardware vs software mismatch or the account was removed).
- "no supported wallets detected dexscreener metamask" — provider injection failed (site can't detect MetaMask or the injected provider is blocked).
- "not a metamask wallet error" — dApp or library rejected the provider object (mismatch between expected wallet APIs).
- "not a v3 wallet metamask" — dApp expects an old JSON keystore format (not how MetaMask exposes accounts).
- "this session is already connected metamask" / "this account has already been connected to metamask" — stale session state on the dApp or cached permissions.
How to fix connection & unlock errors — step by step
Please unlock account / not connected
Step-by-step:
- Open the extension or mobile app and enter your password to unlock. Don't skip this.
- Go to the dApp and click "Connect Wallet" again. Approve the connection popup.
- If the popup doesn't appear, open the extension UI and check "Connected sites" (Settings → Connections) and allow the site.
If popups are blocked, disable popup-blocking for the site, or use the app's in‑app browser (see walletconnect-and-mobile-browser).
But don't panic. Often the fix is three clicks.
No keyring found / missing account
Why this happens: the dApp requests an address that MetaMask no longer manages (for instance a hardware account that isn't connected, or an account you removed).
Step-by-step:
- Confirm the account address shown in MetaMask matches the dApp request.
- If you were using a hardware wallet, reconnect the device and re-enable the account in MetaMask (see connect-ledger or connect-trezor).
- If the account was removed, restore it using your seed phrase (only in the official app/extension) or import the private key (see import-and-recovery).
Warning: exporting/importing private keys carries risk. Use the seed phrase restore if possible and never paste your seed into untrusted pages.
No supported wallets detected (Dexscreener) & provider detection
Dexscreener and similar sites detect wallets by looking for an injected provider or offering WalletConnect. If you see "no supported wallets detected dexscreener metamask":
- Make sure the extension is enabled and the site is allowed to access it.
- Try connecting with WalletConnect from mobile (walletconnect-and-mobile-browser).
- If you control the browser, check extensions/privacy settings; some browsers block injected providers by default.
If you're a developer seeing this, open the browser console — the provider detection trace will show whether window.ethereum is present. (See developer-integration.)
And here's the blunt truth: many detection problems are browser-policy problems, not MetaMask bugs.
Signing, session and "already connected" errors
Common messages: "this session is already connected metamask" or "this account has already been connected to metamask." They mean the dApp thinks the session is active and your wallet is still authorized, but something is out of sync.
Fixes:
- Disconnect from the dApp inside MetaMask (Settings → Connections → Remove the site). Then reconnect.
- On the dApp, look for a "Disconnect" or "Log out" option and use it before reconnecting.
- If pending transactions block new interactions, use Settings → Advanced → Reset Account to clear local nonce history (this does not move funds). See reset-remove.
Advanced troubleshooting: reset, RPC and pending txs
If transactions keep failing or the wallet shows the wrong network, try these steps:
- Check the RPC endpoint. If the dApp is on a different chain, switch networks or add the custom RPC (see add-custom-network, add-bsc).
- Clear the dApp site data in your browser (cookie/cache) and retry.
- Use the extension's "Reset Account" to remove stuck pending transactions — it only clears local history.
- If provider or extension data corrupted, remove and reinstall the extension, then restore from your seed phrase. (Only do this if you have your seed safely backed up — see backup-and-recovery-options).
Prevention and security (avoiding future errors)
- Keep a secure, offline backup of your seed phrase. See backup-and-recovery-options.
- Revoke token approvals you no longer use (I once approved unlimited allowance by accident; I revoked it immediately). See revoke-approvals.
- Use WalletConnect when browser injections fail on mobile. See walletconnect-and-mobile-browser.
- For repeated connection issues on a specific dApp, check dApp docs or try connecting with a different provider temporarily.
Quick error → fix reference table
| Error message |
What it usually means |
Quick fix |
| not connected metamask |
dApp can't see an unlocked/authorized account |
Unlock wallet, click Connect, allow site access |
| please unlock account in metamask |
Wallet is locked |
Open extension/app and unlock with password |
| no keyring found for the requested account metamask |
Address not in active keyrings (hardware vs software mismatch) |
Reconnect hardware or restore/import the account (import-and-recovery) |
| no supported wallets detected dexscreener metamask |
Provider not injected or blocked |
Enable extension or use WalletConnect (walletconnect-and-mobile-browser) |
| not a metamask wallet error / not a v3 wallet metamask |
dApp expects different wallet API or keystore format |
Try WalletConnect or check dApp instructions; avoid exporting seed |
| this session is already connected metamask / this account has already been connected to metamask |
Stale session state |
Disconnect from site in MetaMask settings, clear cache, reconnect |
FAQ
Q: Is it safe to keep crypto in a hot wallet?
A: Hot wallets are convenient for daily DeFi and swaps but less secure than hardware wallets. For small balances and day-to-day trading, they're fine — for large holdings, pair with a hardware wallet (see hardware-best-practices).
Q: How do I revoke token approvals?
A: Revoke approvals either in the dApp you used to grant them or use the on‑chain revoke feature (see revoke-approvals). Revoke the allowance rather than transferring keys or seed phrases.
Q: What happens if I lose my phone?
A: Losing the device doesn't move funds if you controlled the seed phrase. Use your seed phrase to restore in a fresh install. If you used cloud backup, understand the trade-offs — read backup-and-recovery-options.
Conclusion & next steps
Connection and signing errors are usually permissions, network, or provider-detection problems. Start with the simple steps: unlock, reconnect, and confirm networks. If that fails, disconnect the site from MetaMask, clear site data, and reauthorize. For persistent or advanced issues, follow the related guides on extension-troubleshooting, mobile-sync-troubleshooting, and reset-remove.
If you want a concise checklist to save, grab the quick table above or bookmark this page. In my experience the single most time-saving habit is keeping a verified seed backup and learning how to revoke approvals — both save headaches and money later.
Need step-by-step help for a specific error? See the install and setup guides: install-extension and install-mobile.
