The Ethereum ecosystem thrives on innovation, and one of the most powerful tools for developers and enthusiasts is the Goerli test network. Designed as a robust testing ground for decentralized applications (dApps), smart contracts, and Layer 1 and Layer 2 solutions, Goerli enables risk-free experimentation before deploying to Ethereum’s mainnet.
Although Goerli is now deprecated and gradually being replaced by newer testnets like Sepolia, many legacy projects and learning environments still rely on it. This comprehensive guide walks you through how to add Goerli to MetaMask, how to obtain Goerli ETH via faucets, and how to troubleshoot common issues—ensuring you're fully equipped for hands-on blockchain development.
What Is the Goerli Test Network?
Goerli was one of Ethereum’s most widely adopted proof-of-authority (PoA) testnets, allowing developers to simulate real-world conditions without spending real funds. Here's what made it stand out:
- Purpose-Built for Testing: Goerli ETH is not a tradable asset but serves exclusively for testing transactions, gas fees, and dApp interactions.
- Cross-Client Compatibility: Supports multiple Ethereum clients such as Geth, Nethermind, and Parity, enhancing network resilience.
- Community-Driven Validation: Validators are selected based on reputation, improving security and reliability in a test environment.
While new projects are encouraged to use Sepolia or Holesovice, understanding Goerli remains valuable for educational purposes and maintaining older test environments.
Why Add Goerli to MetaMask?
Integrating the Goerli testnet with your MetaMask wallet unlocks several key benefits:
- ✅ Safe Development Environment: Test dApps and smart contracts without risking real funds.
- ✅ Easy Access to Test ETH: Use free faucets to get Goerli ETH instantly.
- ✅ Full EVM Compatibility: Interact seamlessly with Ethereum Virtual Machine-based tools and protocols.
Whether you're building your first decentralized app or learning blockchain fundamentals, Goerli offers a realistic sandbox experience.
👉 Discover tools that simplify Ethereum development and testing today.
Prerequisites: Setting Up MetaMask
Before adding any test network, ensure your MetaMask wallet is installed and secured. If you’re starting from scratch, follow these steps:
- Download the Extension: Visit the official MetaMask website and install the browser extension for Chrome, Firefox, or Brave.
- Create a Wallet: Choose “Create a New Wallet” and set a strong password.
- Back Up Your Recovery Phrase: Write down your 12-word seed phrase and store it securely—never share it online.
- Confirm Setup: Re-enter your recovery phrase to verify backup.
Once configured, your wallet is ready to connect to Ethereum-compatible networks—including testnets like Goerli.
Step-by-Step: How to Add Goerli to MetaMask
Adding Goerli manually or through trusted platforms ensures accurate configuration. Follow either method below:
Method 1: Using ChainList (Recommended)
ChainList simplifies network integration by verifying correct RPC details.
- Go to ChainList.org and enable "Include Testnets".
- Search for "Goerli" in the search bar.
- Connect your MetaMask wallet when prompted.
- Click "Add to MetaMask" next to the Goerli entry.
- Confirm the network addition in your MetaMask popup.
MetaMask will now display "Goerli Test Network" at the top of your interface.
Manual Configuration (Alternative)
If ChainList isn't accessible, input these settings directly into MetaMask:
- Network Name: Goerli
- New RPC URL:
https://goerli.infura.io/v3/YOUR_INFURA_KEY(replace with your Infura project ID) - Chain ID:
5 - Currency Symbol:
ETH - Block Explorer URL:
https://goerli.etherscan.io
🔐 Tip: Always double-check the Chain ID (5) and RPC URL to avoid phishing risks.
How to Get Free Goerli ETH From Faucets
With Goerli added, you’ll need test ETH to interact with dApps. Several reputable faucets distribute Goerli ETH for free:
Top Goerli ETH Faucets
- Alchemy Goerli Faucet – Requires Alchemy account
- QuickNode Drip Tool – Simple interface, email verification
- Linea Goerli Faucet – Operated by ConsenSys
- Moralis Faucet – Supports multiple testnets
Steps to Claim Test ETH
- Navigate to your chosen faucet.
- Connect your MetaMask wallet (ensure it’s set to Goerli).
- Enter your wallet address if required.
- Complete a CAPTCHA or social verification.
- Click “Send” or “Claim” to receive test tokens.
Most faucets limit claims to once per day or per wallet to prevent abuse.
👉 Access advanced blockchain tools that streamline testnet workflows.
Troubleshooting Common Issues
Even with careful setup, issues may arise. Here’s how to resolve them:
❌ Network Not Appearing?
Ensure "Show test networks" is enabled in MetaMask:
- Open MetaMask → Settings → Advanced
- Toggle on "Show test networks"
❌ Transaction Failing?
- Check if you have sufficient Goerli ETH for gas fees.
- Verify that your wallet is connected to the correct network (Goerli, not Mainnet).
❌ Invalid Chain ID Error?
Recheck all fields during manual setup—especially Chain ID (5) and RPC URL.
❌ Faucet Not Sending ETH?
- Confirm your wallet address is correctly entered.
- Some faucets require prior activity on the network or email verification.
Still stuck? Join developer communities like Ethereum Stack Exchange or Discord groups for peer support.
Frequently Asked Questions (FAQ)
Q: Can I convert real ETH to Goerli ETH?
No direct conversion exists, but bridges like LayerZero's Testnet Bridge allow swapping mainnet ETH for testnet equivalents. However, due to Goerli’s deprecation, consider using Sepolia instead.
Q: What is the Goerli chain ID?
The chain ID for Goerli is 5. This unique identifier ensures your wallet connects securely to the correct network.
Q: Is Goerli still active?
Goerli has been deprecated as of 2025 and is no longer recommended for new projects. Developers should migrate to Sepolia or upcoming testnets like Holesovice.
Q: Why can’t I see my Goerli ETH after claiming?
First, confirm the transaction succeeded on Etherscan (e.g., https://goerli.etherscan.io). If confirmed but not visible:
- Click “Import Tokens” in MetaMask
- Manually add the Goerli ETH token contract address:
0xB4FBF271143F4FBf7B91A5ded31805e42b2208d6
Q: Are Goerli ETH faucets safe?
Yes—official faucets from Alchemy, QuickNode, and ConsenSys are trustworthy. Avoid third-party sites requesting private keys or seed phrases.
Q: Can I deploy smart contracts on Goerli?
Yes, while deprecated, Goerli still supports contract deployment for testing. For long-term projects, use Sepolia or local development environments like Hardhat.
Final Thoughts
Adding the Goerli test network to MetaMask and acquiring test ETH via faucets is a foundational skill for anyone exploring Ethereum development. Despite its deprecation, mastering Goerli builds transferable knowledge applicable to modern testnets.
As the ecosystem evolves, tools like OKX Web3 Wallet also offer built-in support for multiple test networks, simplifying access even further.
👉 Stay ahead in blockchain development with cutting-edge crypto tools and insights.
Whether you're testing dApps, learning Solidity, or experimenting with DeFi protocols, understanding test environments empowers confident innovation—without financial risk. Happy coding!