A primary name tells apps which ENS name to show when they look up your wallet. Without one, sites show your 0x address; with one, they show yourname.eth. Set it once and any ENS-aware app picks it up. For the steps to set one, see Set your primary name.
 |
Good to know
The records live on the name itself, not on individual apps. That's why your avatar and social handles show up the same way on every ENS-aware site: each site is reading the same records, not asking you to fill out a new profile per site.
Before and after
Here's the same wallet shown in different places: as 0x982B…2179 on a site that doesn't read ENS, and as the primary name on sites that do.
Etherscan.io/address/0x982Bb9d000bFEe18FD68C11505C11A4F900B2179
app.uniswap.org/swap
efp.app/0x982bb9d000bfee18fd68c11505c11a4f900b2179
The two pieces
A primary name isn't a single setting. It's a pair of records that match each other:
ETH Address on the name:
yourname.ethpoints at your0xaddress. You set this on the name's profile in the ENS App.Primary name on the wallet — your
0xaddress points back atyourname.eth. You set this at primary.ens.domains.
Both need to be in place. If only one is set, apps either don't show the name, or show stale information. The ENS App's Settings has a single flow that handles both for the common case. See Set your primary name.
 |
 |
Where it shows up
Once both records are in place, your primary name surfaces in apps that support it.
In the ENS App
While you're connected with the wallet that set it, you'll see your primary name and its avatar in the top-right corner, and a "Your primary name" badge on the profile. That badge is your own confirmation; other visitors don't see it.
 |
You can also search a 0x address in the ENS App to see what primary name (if any) is set on it. Open the More tab to see Default and Network (L2) primary names listed in the primary name section.
 |
 |
 |
In wallets and dApps
Wallets and dApps that read ENS records in real time pick up your primary name and avatar right after the transaction confirms. Examples include MetaMask, Rainbow, and Uniswap. Cached sites like Etherscan or OpenSea can take a day or two. If a site still shows the wrong thing, see Fix primary name problems.
 |
On OpenSea
OpenSea shows your primary name on your profile page next to your wallet address. OpenSea caches primary name changes, so an update can take a day or two to appear.
 |
On Etherscan
Etherscan shows your primary name on address pages and in the "from" and "to" fields of transaction lists. Two limits to know about:
Etherscan doesn't show DNS-imported ENS names as primary names.
Etherscan may not show a primary name that's set only on an L2 (a Network primary name). If yours is L2-only and doesn't appear, this is why.
 |
 |
What you can attach to a name
A name can also hold records: an avatar, social handles, a website and email, and addresses on other chains. See Edit your ENS profile.
Can a subname be a primary name?
Yes. A subname (a name under your main one, like alice.yourname.eth) can be set as a primary name just like a .eth second-level name. To create subnames, see Create or delete subnames.
 |