> 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-foxwallet.md).

# Add Lumia to FoxWallet

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

**Prerequisites:** FoxWallet 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 on another device or 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 the network selector**

In FoxWallet, open the network selector (usually the chain icon at the top of the wallet screen).
{% endstep %}

{% step %}
**Find Add Custom Network**

Look for **Add Custom Network** / **Manage Networks → Add Network**. Exact wording can vary between FoxWallet app versions.
{% 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**
* **RPC URL**
* **Chain ID**
* **Currency symbol** (do not guess a symbol yourself)
* **Block explorer URL**
  {% endstep %}

{% step %}
**Save and switch**

Save, then switch to the new network from the selector.
{% endstep %}
{% endstepper %}

### Verify it worked

FoxWallet's active-network indicator shows the network you added, and the chain ID in its network details matches [`/reference/networks`](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/reference/networks-and-endpoints) exactly.

### Troubleshooting

<details>

<summary>Can't find "Add Custom Network"</summary>

Check you're on a FoxWallet version that supports custom EVM networks; the menu path has moved between versions.

</details>

<details>

<summary>Network saves but shows a zero balance you expected to see</summary>

Confirm you funded the same address this wallet is showing, on the same network (mainnet vs. Beam are separate balances; see [Accounts & wallets on Lumia](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/build-on-lumia/wallets/accounts-and-wallets-on-lumia)).

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