How to add a custom network to MetaMask?

To connect to a custom network in MetaMask, open the wallet, navigate to network settings, and add the network name, RPC URL, Chain ID, symbol, and optional explorer URL. Then save to connect.

Feb 28, 2025 at 05:08 pm

• Network name : Fill in the name you want to set for this custom network here. For example, you want to connect to a specific test network, and you can name it "[Test Network Name] Test Network". The name can be set according to your preferences and network usage, so that you can clearly identify it when switching networks. This name will not affect the actual connection of the network, but will only serve as an identification function.

• Added RPC URL : This is one of the most important fields. The RPC (Remote Procedure Call) URL is the remote procedure call address of the custom network you want to connect to. This address is provided by the network operator, and different custom networks have different RPC URLs. For example, some test networks of Ethereum such as Ropsten, Rinkeby, etc. have their own specific RPC URLs. When filling in, be sure to ensure the accuracy of the URL, as a single character error may cause the connection to the network. If you are not sure about the URL, you can search for it from the network administrator or in the relevant blockchain community and project official documents.

• Chain ID : Chain ID is a unique identifier for each blockchain network. Different blockchain networks have different chain IDs. For example, the chain ID of the Ethereum main network is 1, while the chain ID of the Ropsten test network is 3. The purpose of chain ID is to enable MetaMask to accurately identify the network you are connected to and prevent confusion with other networks. Similarly, the value of the chain ID is determined by the network operator, and you need to find the correct chain ID in the official documents or relevant information to fill in it.

• Symbol : Fill in the symbol of the cryptocurrency used by the network here. For example, the symbol of Ethereum is ETH. In a custom network, if the network uses its own token, you need to fill in the symbol of the token. This symbol will be displayed in the wallet interface to facilitate you to identify assets in the network.

• Block Browser URL : Block Browser is a tool used to view transactions, blocks and other information on the blockchain. Fill in the corresponding block browser URL of the network, and you can easily view transaction history and other information in your wallet. Similarly, different custom networks have different block browsers, and you need to get the correct URL from the official network to fill in. If the network does not have an officially specified block browser, this item can be left blank, but filling in the correct block browser URL will bring more convenience to your use.

• Unable to save settings : If there is no response after clicking the save button, first check whether the network connection is normal. Unstable network connections may cause settings to fail to save. Also, carefully check the information you fill out to make sure there are no omissions or errors. Especially the RPC URL and chain ID, any errors may cause the settings to fail to save. You can try to re-enter the information, or copy and paste the correct information to avoid possible errors when manually entering it.

• Assets cannot be displayed after connecting to the network : If you successfully connect to a custom network, but the assets in that network are not displayed in the wallet, it may be because you did not correctly import the private key or mnemonic for the corresponding wallet address of the network. You need to import the network's wallet information in MetaMask to display the corresponding assets. In addition, some networks may need to manually add token contract addresses to display specific token assets. You can find the relevant token contract addresses in the official network documentation and add them to your wallet.

• Slow or timeout of network connection : This may be caused by congestion in RPC nodes or network instability. You can try to replace other available RPC URLs. Usually, users will share some alternate RPC node addresses in the blockchain community or project official forum. In addition, check your local network environment to ensure that the network connection is stable, you can also try switching the network, such as switching from Wi-Fi to mobile data, or vice versa, see if the connection can be improved.

• Information security : When obtaining and filling in relevant information about a custom network, be sure to ensure that the information source is reliable. Obtaining information such as RPC URLs from untrusted sources may lead to wallet information leakage and asset losses. Try to obtain network information from official documents, official communities or officially designated channels.

• Network stability : Custom networks may cause network instability due to various reasons, such as node maintenance, network attacks, etc. Pay attention to network status when using a custom network for important operations, such as transactions. If the network is unstable, it is recommended to wait until the network returns to normal before operating to avoid transaction failure or other unexpected situations.

• Wallet Version : Make sure your MetaMask wallet is the latest version. Newer versions of wallets usually fix some known issues, improving stability and security. When adding a custom network, if you encounter problems, you can also try to update the wallet version to see if it can solve the problem. You can check for updates available on the MetaMask official website or in the browser extension store.