Skip to main content

Set your primary name

Set which ENS name represents you across apps and wallets via the dashboard prompt or the Edit Profile page.

ENS App and Explorer are on the Sepolia testnet. Features may change before mainnet.

Your primary name is what apps show instead of your 0x123...456 address. For how it works, see What is a primary name?

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

There are two ways to set it. Use either:

  • Dashboard: opens a selection of names your wallet owns.

  • Edit Profile: sets a name directly from within that name's profile.

Good to know

  • ETH address record warning: if the name doesn't already point to your wallet via the ETH address record, the app warns you and offers to set it automatically. You can proceed or cancel.

  • When the transaction confirms, your primary name updates. In Edit Profile you'll see a primary name tick under the name.

  • The Dashboard selection lists every name your wallet owns, including subnames you've created (e.g. team.yourname.eth).

Use the Dashboard

Note: onchain changes cost gas — the network fee Ethereum charges to process a transaction. It is paid in ETH from your connected wallet and goes to the network, not to ENS. Your wallet shows the exact fee before you approve.

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

  2. Select Dashboard.

  3. Open the primary name dropdown and choose the name you want.

  4. Select Set as primary.

  5. Confirm the transaction in your wallet.

The account button in the top-right corner of the ENS App, opened to show Dashboard
The Choose Primary Name list, with one name selected and the Set as Primary button below

Use Edit Profile

  1. Open the profile editor for the name you want to set as primary.

  2. Select Set primary name.

  3. Confirm the transaction in your wallet.

A name's profile page in the ENS App, showing Wallet Addresses and Links with the Edit Profile button below

The Address section of the profile editor in the ENS App, listing Ethereum, Bitcoin, Optimism and Arbitrum One addresses, with a Set Primary Name button
The Set Primary Name confirmation, saying it sets banana.eth as the primary name, with Cancel and Set as Primary buttons

Common questions

Do I have to pay gas to set a primary name?

Yes. Setting a primary name is a gas-only transaction.

Can I set a subname as my primary?

Yes, a subname can be your primary name. Follow the same process from the name's profile, or in your Dashboard.

Why does my address show instead of my name?

If apps still show your 0x123...456 address, you haven't set a primary name on the wallet yet. Owning a name is not the same as setting it as primary. Use the Dashboard or the Edit Profile page to set one.

What if I want to switch primaries later?

You can change your primary name at any time.

How will others know I've set a primary?

They'll see your ENS name instead of your 0x123...456 address across apps that support ENS, including the ENS App and ENS Explorer.

Did this answer your question?

Related Articles