Quick overview
This guide shows practical, step-by-step instructions to connect PancakeSwap to MetaMask — on desktop and on mobile (including how to connect PancakeSwap to MetaMask iPhone). I tested these flows while swapping BEP-20 tokens and toggling networks, and I'll share the common errors I ran into (and how I fixed them). Short version: you need MetaMask installed, unlocked, and set to the Binance Smart Chain (BSC) network or connected via WalletConnect / the mobile in-app browser.
Why PancakeSwap needs BSC in MetaMask
PancakeSwap runs on Binance Smart Chain (BSC), an EVM-compatible blockchain. MetaMask defaults to Ethereum mainnet, so PancakeSwap won’t interact until your wallet points at BSC. Think of networks like different bank accounts: the address stays the same format, but funds and contracts live on separate chains. If MetaMask is on the wrong network, the DApp can’t see your BSC tokens.
If you need a walkthrough for adding BSC to MetaMask, follow the step-by-step instructions here: [/add-bsc-network].
Step-by-step: Connect PancakeSwap to MetaMask (Desktop)
How to connect PancakeSwap to MetaMask (desktop) — step by step.
- Install and unlock MetaMask in a compatible browser (Chrome, Brave, Firefox). I keep the extension visible on my toolbar. Small tip: pin the extension so it’s easy to open.
- Switch MetaMask to BSC. If BSC isn’t listed, add it first (see [/add-bsc-network]).
- Open https://pancakeswap.finance in a regular browser tab (check the URL).
- Click Connect Wallet on PancakeSwap and choose MetaMask (sometimes listed as "Browser" or "Injected").
- MetaMask will pop up and ask to connect accounts. Select the account you want to use and click Confirm.
- Once connected, the PancakeSwap interface will show your BSC address and balances.
I’ve connected this way dozens of times. It’s reliable when the extension is allowed to inject the provider into the page.
Step-by-step: Connect PancakeSwap to MetaMask (iPhone & Android)
Mobile behaves differently. Which method is best depends on whether you use the MetaMask mobile app or a separate browser.
A. MetaMask mobile in-app browser (recommended for most users)
- Install the MetaMask mobile app (see [/install-metamask-mobile-app]).
- Open the app and unlock your wallet.
- Use the browser tab inside MetaMask to navigate to pancakeswap.finance.
- Tap Connect Wallet → choose MetaMask (it should detect the in-app provider) and approve the connection.
B. WalletConnect (alternative)
- Open PancakeSwap in Safari or Chrome on your phone.
- Tap Connect Wallet → choose WalletConnect.
- If MetaMask mobile supports WalletConnect on your device, you may get a deep link to approve the connection; otherwise, use a compatible wallet app that supports WalletConnect.
Why use the in-app browser? Because many mobile browsers don’t allow extensions or injected providers, so PancakeSwap can report "no provider" (more on that below). Connect PancakeSwap to MetaMask iPhone by using MetaMask’s built-in browser and you’ll avoid that issue.
And yes, I once tried to connect via Safari and hit a roadblock (no provider was found). Switching to the MetaMask browser fixed it.
Connection methods at a glance
| Method |
Best for |
Pros |
Cons |
| Browser extension (desktop) |
Regular traders on desktop |
Fast, direct injection; easy wallet switching |
Requires compatible browser and unlocked extension |
| MetaMask mobile in-app browser |
Mobile-first users (iPhone/Android) |
Simple connect flow; no QR needed |
Only accessible inside the MetaMask app |
| WalletConnect (QR/deep link) |
Mobile linking from external browsers |
Works across many wallets |
Some wallets may not support WalletConnect v2 or deep links reliably |
Common connection errors & fixes
Why does PancakeSwap say "pancakeswap no provider was found" or "can't connect pancakeswap to metamask"? Here are frequent causes and how to resolve them.
Error: "No provider was found"
- Cause: MetaMask extension not installed, disabled, or the site is opened in an environment that blocks injected providers (in-app WebViews, some mobile browsers).
- Fix: Open the DApp in a supported browser with MetaMask enabled, or use the MetaMask mobile in-app browser. See [/mobile-dapp-browser] and [/troubleshooting-dapp-connections].
Error: Cannot connect or MetaMask not showing connection prompt
- Cause: MetaMask locked, blocked by popup blocker, or network mismatch.
- Fix: Unlock MetaMask, disable pop-up blockers for the site, switch MetaMask to BSC, then refresh the page.
Error: PancakeSwap MetaMask mobile issue (deep links failing)
- Cause: WalletConnect version mismatch or missing deep link support.
- Fix: Use the MetaMask in-app browser or try a different WalletConnect-compatible wallet. See [/walletconnect-guide].
Error: Token balances not visible after connect
- Cause: Wrong network selected (Ethereum instead of BSC) or missing custom token in MetaMask.
- Fix: Switch to BSC (or add token contract address under token management). See [/add-bsc-network] and [/token-management].
If you get a "pancakeswap metamask connect error" message, check the browser console for details (right-click → Inspect → Console) — it often shows a useful error string.
Security checklist before connecting
- Verify domain: confirm you’re on the correct PancakeSwap URL and using HTTPS.
- Check contract addresses: if you’ll be approving tokens, confirm the token contract address on a reputable explorer.
- Limit token approvals: avoid unlimited token allowance unless necessary (use a revoke tool afterward). See [/token-approvals-revoke].
- Consider a hardware wallet for larger balances: connect via Ledger/Trezor for an extra security layer (see [/connect-ledger] and [/connect-trezor]).
But don’t let fear stop you from learning. Small, frequent swaps on a hot wallet are common; I do them for testing and small trades.
Advanced troubleshooting
If the basic fixes don’t work, try these steps:
- Update MetaMask extension/app to the latest version.
- Clear site data and cache, then re-open the DApp.
- Temporarily disable other browser extensions that may interfere (privacy blockers, ad blockers).
- Enable MetaMask in Incognito mode if you’re testing in that window (Chrome: Extensions → Details → Allow in incognito).
- Test with another browser or another device to isolate the problem.
- If you added a custom RPC for BSC, confirm the chain ID and RPC endpoint match the network (mistyped RPC settings can cause connection problems).
If you want a command-level check, open the browser console and look for provider errors — they often reveal whether window.ethereum is undefined (meaning no injected provider).
Who this workflow is for (and who should look elsewhere)
This workflow suits everyday DeFi users who want to trade BEP-20 tokens, provide liquidity, or use PancakeSwap from a personal MetaMask wallet. I use MetaMask for quick swaps and small staking experiments.
Who might look elsewhere: if you store large sums long-term, consider hardware wallets or multisig setups (see [/hardware-wallets-overview] and [/multisig-gnosis]) to reduce hot-wallet risk.
FAQ
Q: Is it safe to keep crypto in a hot wallet like MetaMask?
A: Hot wallets are convenient but carry more risk than cold storage. For frequent trading and small positions they’re practical. For large holdings, consider hardware wallets and split your holdings.
Q: How do I revoke token approvals for PancakeSwap?
A: Use a revoke tool or the token approval pages to revoke unlimited allowances. See [/token-approvals-revoke] for step-by-step instructions.
Q: What happens if I lose my phone after connecting MetaMask to PancakeSwap on mobile?
A: If you lose your phone, anyone with the device and unlocked wallet can act. Restore your wallet on a new device only from your seed phrase (never share it). See [/backup-recovery-seed] for recovery best practices.
Q: I see "can't connect pancakeswap to metamask" — what quick checklist should I run?
A: Unlock MetaMask, ensure it’s set to BSC, refresh the PancakeSwap page, disable blockers, and use the MetaMask in-app browser on mobile. See [/troubleshooting-dapp-connections].
Conclusion & next steps
Connecting PancakeSwap to MetaMask is straightforward once MetaMask is installed, unlocked, and set to the BSC network (or connected via WalletConnect / the MetaMask in-app browser on mobile). If you run into "pancakeswap no provider was found" or other connection errors, follow the troubleshooting checklist above and consult the linked guides for adding BSC, WalletConnect, and token approvals.
Ready to add BSC to MetaMask or set up the mobile app? Start here: [/add-bsc-network] and [/install-metamask-mobile-app].
If you want deeper troubleshooting, see [/troubleshooting-dapp-connections] or WalletConnect guide.
What I've found: patience and small test transactions save time and money. Good luck, and stay cautious with approvals and unknown contracts.
