How to add a custom network RPC
Does this article need to be translated?
MetaMask can access many more networks than just Ethereum mainnet: you can add any EVM-compatible network directly within your wallet and browse Snaps for additional non-EVM interoperability.
The initialism RPC stands for remote procedure call, a set of protocols that allow a client (such as MetaMask) to interact with a blockchain. You can add multiple RPC URLs for a single network and edit the default RPC URL from your list of networks in both Extension and Mobile settings.
Adding a custom RPC URL will disable Smart Transaction capabilities. To re-enable this, you'll need to switch back to the default RPC URL from the network dropdown selector.
On both Mobile and Extension, you can easily add several prominent networks with just a click. These include:
- Arbitrum
- Avalanche
- BNB Chain/BSC
- Base
- Optimism
- Polygon
- zkSync Era
You can find this using the following steps:
- Extension
- Mobile
From the homepage of your wallet, click on the network selector in the top left. Scroll down until you see the 'Additional networks' section. Alternatively, you can also search for the network to add in the search bar.
Tap the "Add" button next to the network to add it to your MetaMask instance.
-
Tap the network selector at the top of the screen. (Alternatively, you can tap the gear icon to access settings, and then go to 'Networks'.)
-
Here you'll see a list of networks that you've already added. Tap the "Add Network" button at the bottom of the screen.
-
You should now see a list of networks you can add under the "Popular" tab, as shown below.
-
When you choose to add one of them, you'll be prompted to confirm your selection and then get the option to switch immediately to that network. All done!
MetaMask is in the process of improving the networking switching experience. As of v12.0, you will no longer have to manually switch between networks while connected to multiple dapps at the same time. This feature is currently available in Extension only.
Adding a network manually
If you don’t see a desired network in the list, you can follow these instructions to establish the network connection manually:
- Extension
- Mobile
-
Click on the network selector button. This will display a list of networks that you've added already.
-
Click "Add custom network":
-
A screen will appear where you can enter the details of the network you wish to add. Click "Save" to add the network.
-
Tap the network selector at the top of the screen.
-
Tap on "Add Network".
-
Switch to the "Custom networks" tab.
-
Fill in the network's details:
After performing the above steps, you can see the custom network in the network selector.
The details for the above fields can be found in our network profiles or docs (i.e. developer documentation) or how-to guides for each network. For example:
After performing the above steps, you will be able to see the custom network the next time you access the network selector.
Adding or editing RPC URLs
You can add multiple RPC URLs for a single network and edit the default RPC URL from your list of networks in both Extension and Mobile settings.
- Extension
- Mobile
- Click the network icon in the top left of your wallet to show the list of enabled networks.
- Locate the desired network you want to edit and click the 3 dots to edit.
- Select the Default RPC URL dropdown field and click “Add RPC URL”.
- Enter the URL, nickname, and save your configurations.
- Tap the network selector at the top in the middle of your wallet to show the list of enabled networks
- Click the 3 dots by the network you want to edit
- Select the Default RPC URL downtown field and click “Add RPC URL”
- Enter the URL, nickname, and click “Add URL” to save your configurations
You can now toggle between various RPC URLs directly from the network drop-down selector when you want to switch providers. To delete any RPC URL, follow the same steps above and click on the trash bin icon to delete.
Adding via Chainlist
For an easy way of adding networks to MetaMask, go to chainid.network, where you can connect MetaMask and add networks with only a few clicks. See our guide for more information.
Also, please note that adding a network on one device does not mean it will appear on another device when accessing the same account. If you add it on Extension, it will not automatically be added to your MetaMask Mobile app yet, and vice versa.
Custom networks will also need to re-added if you uninstall the browser extension or mobile app (after which you'd need to restore your wallet using your Secret Recovery Phrase).