> For the complete documentation index, see [llms.txt](https://docs.lumia.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lumia.org/build-on-lumia/wallets/add-lumia-to-metamask.md).

# Add Lumia to MetaMask

**Who this is for:** developers adding a Lumia network to MetaMask for the first time.

**Prerequisites:** MetaMask installed. Read [Accounts & Wallets on Lumia](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/build-on-lumia/wallets/accounts-and-wallets-on-lumia) first if you haven't used an EVM wallet before.

**Time:** under 2 minutes.

{% stepper %}
{% step %}
**Open Reference in another tab**

Open [`/reference/networks`](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/reference/networks-and-endpoints). You'll copy values from it in step 4. Decide first whether you want **mainnet** or **Beam testnet**; most development work uses Beam.
{% endstep %}

{% step %}
**Open Add network**

In MetaMask, click the network selector at the top of the window, then **Add network**.
{% endstep %}

{% step %}
**Choose Add a network manually**
{% endstep %}

{% step %}
**Fill in the fields**

Using the matching row from [`/reference/networks`](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/reference/networks-and-endpoints):

* **Network name**: e.g. "Lumia Beam Testnet" or "Lumia Mainnet"
* **New RPC URL**: the RPC (HTTPS) value for the network you chose
* **Chain ID**: the chain ID value for that network
* **Currency symbol**: as listed on that page; do not guess a symbol yourself
* **Block explorer URL**: the Explorer value for that network
  {% endstep %}

{% step %}
**Save and confirm**

Click **Save**, then confirm MetaMask switches you to the network you just added.

{% hint style="info" %}
If Lumia's own site or app offers a one-click "Add to MetaMask" button (a `wallet_addEthereumChain` prompt), it fills in the same fields automatically. Compare what it shows you against [`/reference/networks`](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/reference/networks-and-endpoints) before approving, the same way you'd check a manual entry.
{% endhint %}
{% endstep %}
{% endstepper %}

### Verify it worked

MetaMask's network selector shows the network you added, and the chain ID under **Settings → Networks** for that entry matches [`/reference/networks`](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/reference/networks-and-endpoints) exactly.

### Troubleshooting

<details>

<summary>"Could not fetch chain ID" error while saving</summary>

The RPC URL was mistyped, or you copied it from an old tutorial rather than [`/reference/networks`](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/reference/networks-and-endpoints). Retype it.

</details>

<details>

<summary>Chain ID mismatch warning</summary>

You've likely entered a chain ID that doesn't match the RPC endpoint's actual network. Re-copy both fields from the same row of [`/reference/networks`](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/reference/networks-and-endpoints).

</details>

<details>

<summary>You landed on chain ID <code>1952959480</code></summary>

That's a retired network, not Beam. See [`/reference/retired-testnet`](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/reference/retired-testnet-1952959480) and re-add using the current Beam values instead.

</details>