Adding a custom network to MetaMask

Documentation Index

Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt

Use this file to discover all available pages before exploring further.

• In the Chainstack console, open your node’s Access and credentials section and click Connect wallet — MetaMask auto-detects, prompts you to add the network, and switches to it.
• If your browser has no wallet extension or you want to add the network manually (including on mobile), use the manual flow below.

​

One-click: Connect wallet (recommended)

1. In the Chainstack console, open the project and the node you want to use.
2. Scroll to the Access and credentials section.
3. Click Connect wallet.
4. MetaMask (or any other injected wallet) opens and asks you to approve adding the network. The RPC URL, chain ID, currency symbol, and explorer are pre-filled from the node’s metadata.
5. Approve. MetaMask switches to the new network.

​

Manual setup

​

What you need

• Your Chainstack node’s HTTPS endpoint (and authentication key, or username/password if you’re using the password-protected endpoint). See View node access and credentials.
• The target network’s chain ID — look it up at chainlist.org.
• MetaMask installed (browser extension or mobile app).

​

Browser extension (Chrome, Firefox, Edge, Brave)

1. Open MetaMask and unlock your wallet.
2. Click the network selector at the top of the popup → Add a network.
3. Click Add a network manually at the bottom of the list.
4. Fill in the network details:

   Field	Value
   Network name	Anything readable, e.g. BNB Smart Chain (Chainstack)
   New RPC URL	Your Chainstack HTTPS endpoint, e.g. https://bsc-mainnet.core.chainstack.com/AUTH_KEY
   Chain ID	The decimal chain ID from chainlist.org (e.g. 56 for BNB Smart Chain)
   Currency symbol	The native token symbol (e.g. BNB)
   Block explorer URL (optional)	A public explorer for the network (e.g. https://bscscan.com)

5. Click Save. MetaMask switches to the new network.
6. Verify the network name and currency symbol match what you expect.

​

Mobile app (iOS / Android)

1. Open MetaMask Mobile and unlock your wallet.
2. Tap the hamburger menu (top-left).
3. Go to Settings → Networks.
4. Tap Add network → Custom networks tab.
5. Fill in the same fields as in the table above and tap Add.

​

Troubleshooting

• Chain ID mismatch. MetaMask refuses to add the network if the chain ID you typed doesn’t match what the RPC endpoint reports. Double-check the chain ID at chainlist.org.
• Endpoint unreachable. If MetaMask reports the RPC endpoint as offline, verify the URL and authentication key. Test it directly:
  cURL

  curl YOUR_CHAINSTACK_ENDPOINT \
    -H 'content-type: application/json' \
    -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
  
• Use trusted RPC URLs only. Custom networks can route every transaction you sign through the RPC you specify — only add endpoints you control or trust.

​

See also

• Manage your node
• Authentication methods for different scenarios
• chainlist.org — public registry of EVM chain IDs and metadata