Why should I set a primary name?

It makes wallets like MetaMask and Rainbow show your .eth name instead of your long address, makes transactions easier to read, and gives you a consistent identity across apps. Without it, apps fall back to showing the raw address.

Can one address have more than one primary name?

No. A single wallet address can only have one primary name at a time, because the reverse mapping is one-to-one. You can change it at any time as long as you control both the address and the name.

How do I set my primary name?

Own the .eth name you want, open an ENS manager app that supports reverse records, choose the name and select Set Primary Name, then confirm the transaction and pay the gas. It starts showing up in apps automatically.

What Is a Primary ENS Name (and Why You Want One)

Q: What is a primary ENS name?

It is the reverse record. Forward resolution turns a name into an address, while reverse resolution turns an address back into a name. Your primary name answers the question of which ENS name should be displayed for a given wallet address.

ENS BasicsGuide

If you own an ENS name, you have probably heard the phrase "set your primary name." It is one of the most common actions in the ENS ecosystem, and it unlocks most of the everyday benefits of owning a .eth name. But what does it actually mean? Let us break it down.

The Reverse Record, Explained

ENS has two directions of lookup:

Forward resolution: turn a name into an address. Type alice.eth and get the wallet address 0x...
Reverse resolution: turn an address back into a name. Look up 0x... and get alice.eth

The "primary name" is the reverse record. It answers the question: given this wallet address, what ENS name should we display?

When you set a primary name, you are saying: "this address belongs to this .eth name, so show the name whenever you see the address."

Why Set a Primary Name?

The payoff is convenience and clarity. Once your primary name is set:

Wallets like MetaMask and Rainbow show alice.eth instead of your long address
When you send or receive funds, other people see your readable name, not a 42-character string
Your transaction history is easier to read
You establish a consistent identity across apps that support ENS

Without a primary name, your ENS name still resolves forward (people can send you funds by typing your name). But apps cannot automatically know which name belongs to your address, so they fall back to showing the raw address.

One Address, One Primary Name

Here is an important detail: a single wallet address can only have one primary name at a time. The mapping is one-to-one in the reverse direction.

That does not mean you are stuck. You can change your primary name at any time, as long as you control both the address and the name you want to use. So if you register a better name later, you can switch your primary name to it.

But note: a primary name must be owned by the address that claims it, and the name must point back to that same address. This creates a verified link between the two. It is this two-way link that makes the primary name trustworthy.

How to Set Your Primary Name

The exact steps depend on your wallet and which ENS app you use, but the general flow is:

Make sure you own the .eth name you want to use
Open an ENS manager app that supports reverse records
Choose the name and select "Set Primary Name" (or the reverse record option)
Confirm the transaction and pay the gas

The whole process takes a minute. Once it is set, the name starts showing up in apps automatically. You do not need to register it separately anywhere else.

A Few Things to Keep in Mind

Gas costs apply. Setting a primary name is a blockchain transaction, so it costs gas. Prices vary with network congestion, so you may want to wait for a quiet moment.

It is separate from your records. Your primary name (reverse record) and your other records (like your avatar or the address your name points to) are different things. Setting one does not change the other.

The name and address must match. To set alice.eth as the primary name of wallet X, wallet X must own alice.eth, and alice.eth must point to wallet X. If either side does not match, you cannot claim that primary name.

You can always change it. Nothing about a primary name is permanent. Change it whenever your identity or favorite name changes.

Common Confusions

"Is my primary name the same as the wallet my name points to?"

Not exactly. The wallet your name points to is set through forward records. The primary name is the reverse record (address to name). They are related but separate. Setting one does not automatically set the other.

"Do I need a primary name to receive crypto?"

No. Forward resolution is what lets people send you funds by typing your name. The primary name is about display and identity. Both are nice, but only forward resolution is required to receive payments.

"Can I have two primary names?"

No. Each address can have only one primary name at a time, because the reverse mapping is one-to-one.

Key Takeaways

Your primary name is the reverse record: it maps your address back to a name
It makes apps show your .eth name instead of your long address
Each address can have only one primary name
The name and address must match for you to set it
You can change your primary name anytime
Setting it costs gas, so pick a quiet moment

Now that your primary name is set, check out our guide to subnames to learn how to organize multiple identities.