> ## 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.

# Adding a custom network to MetaMask

> Connect MetaMask to a Chainstack RPC endpoint. Use the one-click Connect wallet button in the Chainstack console, or add the network manually on the browser extension or mobile app.

**TLDR:**

* In the [Chainstack console](https://console.chainstack.com/), 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 [Manual setup](#manual-setup).

## One-click: Connect wallet (recommended)

This is the fastest path and avoids typos in the RPC URL or chain ID.

1. In the [Chainstack console](https://console.chainstack.com/), 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.

<Note>
  If the **Connect wallet** button doesn't react, make sure your wallet extension is installed and unlocked in the same browser tab.
</Note>

## Manual setup

Use the manual flow when you don't have a wallet extension in the current browser (for example, on mobile), or when you want to point MetaMask at the password-protected endpoint.

### What you need

* Your Chainstack node's HTTPS endpoint, including its auth token, or the username and password if you're using the password-protected endpoint. See [View node access and credentials](/docs/manage-your-node#view-node-access-and-credentials).
* The target network's chain ID — look it up at [chainlist.org](https://chainlist.org/).
* MetaMask installed ([browser extension](https://metamask.io/download/) or [mobile app](https://metamask.io/)).

### 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 full Chainstack HTTPS endpoint, `YOUR_CHAINSTACK_ENDPOINT`, with the auth token included |
   | Chain ID | The decimal chain ID from [chainlist.org](https://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 [browser extension](#browser-extension-chrome-firefox-edge-brave) network details table 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 endpoint URL and auth token. Test it directly:

  <CodeGroup>
    ```bash cURL theme={"system"}
    curl YOUR_CHAINSTACK_ENDPOINT \
      -H 'content-type: application/json' \
      -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
    ```
  </CodeGroup>

* **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

* [Adding a custom RPC endpoint to Rabby](/docs/adding-a-custom-rpc-endpoint-to-rabby)
* [Manage your node](/docs/manage-your-node)
* [Authentication methods for different scenarios](/docs/authentication-methods-for-different-scenarios)
* [chainlist.org](https://chainlist.org/) — public registry of EVM chain IDs and metadata