Skip to main content

Set your primary name

Set which of your names apps and wallets show instead of your address, from your Dashboard in the ENS App. The network fee (gas) is paid in USDC.

Set which of your names apps show instead of your 0x123...456 address. For how it works, see Primary name.

The account button in the top-right corner of the ENS App, showing an avatar and the primary name onshow.eth

Do it from your Dashboard in the ENS App. For a different name on each network, or more control, use ENS Explorer: see Set your primary name (ENS Explorer).

You need your wallet connected. Setting a primary name is a transaction, and its network fee (gas) is paid in USDC.

Set it from the Dashboard

  1. Select your address, or your current primary name, in the top-right corner.

  2. Select Dashboard.

  3. Select the arrow next to your primary name. Choose Primary Name opens.

  4. Pick the name you want.

  5. Select Set as primary.

  6. If the name has no wallet address yet, the app offers to add yours. Select Confirm. If the name isn't upgraded, see the question below instead.

  7. If the name is on ENSv2 and your wallet can't edit its resolver, the app offers to replace the resolver with one your wallet controls, and the button reads Replace & Continue. See the question below.

  8. Approve in your wallet. If the app is also adding your wallet address, approve that first, then the primary name.

  9. When it confirms, the button in the top-right shows the name you chose.

The account menu in the ENS App, open to show Dashboard
The Choose Primary Name window, with bright-lemur.eth selected and the Set as primary button below
The Set this as your primary name? window, warning that the name has no wallet address yet, with Cancel and Confirm

Set it on other networks

The ENS App sets your primary name on Ethereum. To set one on an L2, such as Base or Arbitrum, use ENS Explorer. See Set your primary name (ENS Explorer). If your name doesn't show on a network, see Why isn't my primary name showing?


Common questions

Didn't registration already set one?

It may have. When you register a name in the ENS App, the app makes it your primary name straight after registration, but only if your wallet had no primary name yet and held fewer than five .eth names. Otherwise your primary name stays as it was. To use a different name, change it from your Dashboard.

Can I set a subname as my primary?

Yes. Subnames you own are in the same list in your Dashboard.

What if my name isn't upgraded and has no address?

In the ENS App, a name you haven't upgraded needs an ETH address before you can set it as primary. Upgrade it first (see Upgrade your name to ENSv2), or set it in ENS Explorer (see Set your primary name (ENS Explorer)).

Can I change it later?

Yes, at any time. Follow the steps again and pick a different name.

Why does it say it will keep only my wallet address?

On an ENSv2 name whose resolver your wallet can't change, the app moves the name to a different resolver that your wallet controls. That resolver holds only your wallet address. The old one's other records, such as text records, an avatar or a content hash, stop showing for this name. Add them again afterwards if you need them.

Did this answer your question?