Skip to main content

How do I set my Primary Name?

Set your Primary Name in ENS — and the pre-flight check that catches a missing Set as Primary Name button.

Good to know

  • You need ETH on Ethereum Mainnet for gas — no other cost.

  • Only the wallet set as the name's ETH Address can set it as Primary.

  • If you're on the Manager wallet but not the ETH Address wallet, expect two transactions.


Open app.ens.domains, find your name, click Set as Primary Name, and approve in your wallet. That makes apps show yourname.eth instead of your 0x address. You'll need a bit of ETH on Ethereum Mainnet for gas — no other cost.


Before you start

You need three things:

  • ETH on Ethereum Mainnet for gas.

  • The wallet set as the name's ETH Address connected. Only that wallet sees the Set as Primary Name button. The ETH Address is the wallet your name points at — apps use it to know which wallet owns yourname.eth. If you don't know which wallet it is, open the name's Profile tab in the ENS App and look at the ETH Address row.

  • A minute or so for the transaction to confirm.

Quick check before you click: if you're connected with a different wallet — typically the Manager — the Set as Primary Name button won't appear. Skip to "If you're on the Manager wallet" below.


Steps

  1. Open the ENS App. Go to app.ens.domains and connect your wallet.

  2. Find your name. Search for it and open the Profile tab.

  3. Click Set as Primary Name.

  4. Approve in your wallet. Most confirm in 1–2 blocks (12–24 seconds); busy networks can take longer.

  5. Check it landed. While you're connected with the wallet that set it, you'll see a "Your Primary Name" badge on the profile — that's your own confirmation, other visitors don't see this badge. yourname.eth also appears in the top-right of the ENS App.


If you're on the Manager wallet but not the ETH Address wallet

The Manager is the wallet that controls a name's records — it can change the ETH Address, set text records, and so on. The ETH Address is the wallet the name points at for receiving funds and for being shown as Primary. These can be two different wallets.

If you're on the Manager but not the ETH Address wallet, you have two options:

  • Switch wallets. Connect with the wallet that's set as the ETH Address, then run steps 3 and 4 above.

  • Point the ETH Address at your current wallet. Only do this if you actually want the new wallet to be the ETH Address — once you change it, funds sent to yourname.eth go to the new wallet, and the old wallet stops receiving them. If you want to keep the current ETH Address, switch wallets instead.

To change the ETH Address (two approvals in your wallet):

  1. Click Start. The ENS App walks you through the ETH Address update.

  2. Approve in your wallet. Most confirm in 1–2 blocks (12–24 seconds).

  3. Click Next. Now you're on the Primary Name step.

  4. Approve a second time.

When both land, the badge and the top-right show your name.


Primary Names on Base, Arbitrum, and other L2s

You can set a different Primary Name on each network — Base, Arbitrum, Optimism, and others. Useful if you want a different name per chain, or if your contract has different wallets across chains. The L2 flow runs on those chains, not Mainnet.


Where your name shows up

  • ENS App — top-right corner and on the profile, right after the transaction confirms.

  • Wallets and dApps that read ENS records in real time — usually right away.

  • Cached sites like Etherscan or OpenSea — can sometimes take a day or two.

If yourname.eth shows in the top-right of the ENS App, the onchain record is set. The rest is downstream caching.


Troubleshooting

The Set as Primary Name button is missing.

You're not on the wallet set as the name's ETH Address. Either switch to that wallet, or follow the two-step path above to point the ETH Address at your current wallet.

The transaction didn't go through.

Check that you have enough ETH on Ethereum Mainnet for gas. If your wallet popup never showed, refresh the page and reconnect.

An old or expired name is still showing as my Primary Name somewhere.

Some apps cache old Primary Name values. Clear your Primary Name from the ENS App to write a fresh onchain state; cached sites catch up over the next day or two.


What's next?

Did this answer your question?