Want to use apps on the Moonbeam network but MetaMask only shows Ethereum by default? You’re not alone — every new network needs to be added to MetaMask by hand (or with a trusted one-click button), and Moonbeam is no exception. The good news is that the whole process takes about five minutes once you know exactly which settings to enter.
In this guide, you’ll learn what the Moonbeam network is, the exact RPC settings MetaMask needs to connect to it, two ways to add it (a fast one-click method and the manual method), how to confirm everything is working, and the mistakes that trip most people up. Everything is written for a beginner, with safety checks along the way.
id=”what-moonbeam-is”>What the Moonbeam network is
Moonbeam is an Ethereum-compatible smart contract network built as a parachain on Polkadot. That description is worth unpacking, because it explains why adding it to MetaMask is both possible and straightforward.
“Ethereum-compatible” means Moonbeam runs the same kind of virtual machine (the EVM) that Ethereum uses. Apps written for Ethereum can run on Moonbeam with minimal changes, and — importantly for you — any Ethereum-style wallet, including MetaMask, can talk to Moonbeam once you tell it the right connection details. Your existing MetaMask address even stays the same: the same private key produces the same address on Moonbeam as on Ethereum.
A “parachain on Polkadot” means Moonbeam is one of many specialized blockchains that plug into the shared security of the Polkadot network. For most users, that background detail doesn’t change how you use the network day to day. What matters practically is this: Moonbeam has its own native currency, called GLMR, which pays for transaction fees on the network — just like ETH pays fees on Ethereum.
Moonbeam’s ecosystem includes decentralized apps for trading, lending, and staking, many of which were first built on Ethereum and then expanded to Moonbeam. If you’ve ever bridged funds to a layer-2 or sidechain and used a new network for the first time, the experience here will feel familiar.
There is also a test network called Moonbase Alpha, which developers use for testing. It works the same way but uses a play token called DEV instead of real GLMR. You generally don’t need Moonbase Alpha unless you’re testing something yourself — this guide focuses on the real Moonbeam network, with a brief note on the testnet settings near the FAQs.
Why you’d add Moonbeam to MetaMask
MetaMask only ships with a handful of built-in networks. Any other network you want to use — Moonbeam included — has to be added explicitly. People usually add Moonbeam for one of a few reasons:
- Using Moonbeam apps. Many DeFi and NFT apps on Moonbeam require your wallet to be connected to the Moonbeam network before they will work. Without it, the app simply can’t see your funds or execute transactions.
- Holding or staking GLMR. If you buy the GLMR token on an exchange and want to withdraw it to your own wallet, MetaMask needs the Moonbeam network configured to display the balance and sign transactions.
- Lower fees than Ethereum mainnet. Transactions on Moonbeam have historically cost less than on Ethereum during congested periods, which is part of the appeal for active DeFi users. (Fees still vary with network demand, so treat this as a general tendency, not a promise.)
- Cross-chain activity. If you bridge assets between Ethereum, Polkadot ecosystem chains, and Moonbeam, keeping Moonbeam in your wallet’s network list makes switching between chains quick.
If you just want to view your balance without adding the network, you could look your address up in a block explorer instead — but for any interaction at all, MetaMask needs the connection.
Adding a network doesn’t move any funds or change your existing wallets. It simply teaches MetaMask how to reach another blockchain. You can always remove a network later, and doing so never deletes your assets — they live on the blockchain, not in the wallet interface.
Before you start: what you need
The whole setup is quick, but a minute of preparation avoids the most common hiccups:
- MetaMask installed and set up. You’ll need the MetaMask browser extension or mobile app with a wallet already created. If you haven’t created one yet, install MetaMask from its official site first — type the address yourself rather than clicking a link in a search ad, which is a common phishing vector. Write down your secret recovery phrase on paper and store it somewhere safe. Support staff will never ask for it.
- A small amount of GLMR for fees (optional but useful). You’ll only need GLMR if you plan to actually transact on Moonbeam. Just adding the network costs nothing.
- The official network details. You’ll find the exact values in the manual section below. As of this guide’s writing, the widely documented settings are: chain ID 1284, RPC URL https://rpc.api.moonbeam.network, currency symbol GLMR, and the explorer at https://moonscan.io. Cross-check these against Moonbeam’s official documentation before you enter them, since endpoints can change over time.
A quick note on chain IDs: the chain ID is the number that uniquely identifies a blockchain. Moonbeam’s is 1284 (shown as 0x504 in hexadecimal). Entering the wrong chain ID is one of the most common mistakes, and MetaMask will usually warn you if something doesn’t line up — take that warning seriously.
If you’re the careful type, you might also enjoy reading our guide on how to switch networks in MetaMask safely before you start clicking around — it covers the habits that keep your funds safe whenever you change chains.
Method 1: the one-click way to add Moonbeam
The fastest way to add Moonbeam is to let a trusted source send the network details to MetaMask automatically. This uses a standard wallet feature (EIP-3085) where a website proposes the network and MetaMask shows you every value before you approve.
Step 1: Open MetaMask and unlock your wallet. Make sure you’re on the account you want to use.
Step 2: Go to a trusted network directory. The safest options are Moonbeam’s own official site or MetaMask’s built-in network directory. Type the address yourself — never reach it through a link someone sent you. Look for a button labeled something like “Add to MetaMask” or “Add Moonbeam network.”
Step 3: Review the proposal carefully. MetaMask will pop up a window showing the network name, RPC URL, chain ID (1284), currency symbol (GLMR), and block explorer. This is your safety checkpoint: compare each value against the official settings. If anything looks off — a strange RPC URL, a wrong chain ID — reject the proposal immediately.
Step 4: Approve, then switch. Click approve, and MetaMask will ask if you want to switch to Moonbeam now. Say yes, and you’re done — the Moonbeam network now appears in your network list.
The one-click method is convenient, but it has one honest weakness: it only works if you can find a trustworthy site offering the button. Random “add network” buttons on unfamiliar sites are exactly how phishing campaigns operate, so the source matters more than the convenience.
Method 2: add Moonbeam manually, step by step
Typing the settings in yourself takes a couple of minutes and removes the need to trust any third-party website. This is the method most security-conscious users prefer.
Step 1: Open the network menu. In MetaMask, click the network dropdown at the top of the wallet window (it probably says “Ethereum Mainnet” right now), then choose “Add network” or “Add a network.”
Step 2: Choose “Add a network manually.” MetaMask will show a form with several fields. Fill them in exactly as follows — and remember to cross-check against Moonbeam’s official docs, since endpoints can change:
- Network name: Moonbeam
- New RPC URL: https://rpc.api.moonbeam.network
- Chain ID: 1284
- Currency symbol: GLMR
- Block explorer URL (optional): https://moonscan.io
Step 3: Save. Click “Save.” MetaMask will validate the details — if the chain ID doesn’t match what the RPC endpoint reports, it will stop you, which is a feature, not a bug.
Step 4: Switch to Moonbeam. MetaMask usually offers to switch to the new network right away. Accept, and you’ll see your balance area show GLMR instead of ETH.
That’s the whole procedure. The manual method and the one-click method end up in exactly the same place: MetaMask with a Moonbeam network entry that you control. Here’s how they compare:
| Aspect | One-click method | Manual method |
|---|---|---|
| Speed | Under a minute | 2–3 minutes |
| Trust required | You must trust the site offering the button | None — you type everything yourself |
| Error risk | Low, but a malicious site could propose wrong values | Typos possible — double-check each field |
| Best for | Convenience on a known-trustworthy site | Maximum safety; recommended for beginners |
| Works offline | No — needs the third-party site | Yes — everything happens inside MetaMask |
If you add networks often — for example, following along with other chain guides like our Polygon setup guide or our Soneium setup guide — the manual method becomes second nature quickly, and it’s the same pattern every time.
How to verify it worked
Don’t just assume the setup succeeded — run these quick checks:
- Check the network list. Open the network dropdown in MetaMask. You should see “Moonbeam” listed, and selecting it should change the currency label in your wallet to GLMR.
- Confirm the chain ID. Go to Settings → Networks → Moonbeam and confirm the chain ID reads 1284. This is the single most important value to get right.
- Look up your address in the explorer. Copy your wallet address, then type the block explorer address (as of this guide’s writing, documented as https://moonscan.io) into your browser yourself and search for your address. If the explorer shows the Moonbeam network and your address, the connection is genuine.
- Send a tiny test transaction. If you hold GLMR and plan to transact, start with a very small amount — a fraction of a GLMR — to a second address you control. Only move the full amount after the test confirms.
If your GLMR balance doesn’t show up after switching networks, don’t panic: the most common cause is that the tokens are on a different network than the one you’re viewing. Double-check which network the funds were sent on before assuming something is wrong.
7 common mistakes (and how to avoid them)
1. Entering the wrong chain ID. Typing 1287 (Moonbase Alpha’s testnet ID) or 1285 instead of 1284 connects you to the wrong network. Always double-check: Moonbeam mainnet is 1284.
2. Using a random RPC URL from a search result. Unofficial RPC endpoints can log your activity or feed you manipulated data. Stick to the documented official endpoint, or one from a provider you trust.
3. Adding the network from a phishing site. Fake sites mimic official pages and their “add network” buttons. Type official addresses yourself; never arrive via a link in a message, ad, or email.
4. Confusing GLMR with other tokens. On Moonbeam, the gas token is GLMR. If an app asks you to pay fees in some other token on Moonbeam, pause and investigate — that’s unusual.
5. Forgetting to switch back. After using Moonbeam, remember to switch back to Ethereum (or whatever network you need) before your next transaction. Sending a transaction on the wrong network is a classic, avoidable error.
6. Approving the network proposal without reading it. The MetaMask popup lists every value the site is proposing. Skimming past it defeats the whole safety mechanism. Read it line by line.
7. Sharing your recovery phrase “to verify” the network. No legitimate site, support agent, or tutorial will ever need your secret recovery phrase. Anyone who asks for it is running a scam — close the page and report it.
FAQs
The Bottom Line
Adding Moonbeam to MetaMask is a five-minute task: either approve a network proposal from a trustworthy site or type in the settings manually — network name Moonbeam, chain ID 1284, RPC https://rpc.api.moonbeam.network, GLMR as the currency, and the Moonscan explorer. The manual method is the safer habit, and verifying the chain ID afterward is the single check that matters most.
Once Moonbeam is in your network list, you can use Moonbeam apps, hold and stake GLMR, and switch between chains freely. Just keep the anti-phishing habits: type official addresses yourself, read every approval popup, and never share your recovery phrase with anyone.
This guide is for education only — not financial advice.
