> ## 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 the manual flow below.

## 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 (and authentication key, or username/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 Chainstack HTTPS endpoint, e.g. `https://bsc-mainnet.core.chainstack.com/AUTH_KEY`           |
   | 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 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:

  <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

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