Skip to main content

Set a Primary name

The Primary name is your reverse record responsible for resolving your wallet address to your ENS name, helping decentralized apps and services display your ENS name based on your Ethereum wallet address.

In this guide we'll show you how to set up your Primary Name in just 3 steps.

https://app.ens.domains

Setting a name as Primary in your wallet is usually a simple affair, but it can be a little complicated if:

  • The name was registered using a third-party service that didn't set the Resolver and ETH Address records by default.
  • The name was purchased on a secondary market and the ETH Address record is still set to the previous owner's wallet.

If either of these applies to you, then you can solve it by following the Prerequisites section below.

1. Prerequisites​

prerequisites

In order to set an ENS name as Primary there are two prerequisites:

  1. The Resolver record must be set to the ENS Public Resolver smart contract.
  2. The ETH Address record must be set to the wallet you're setting the Primary on.

1.1. Set the Resolver​

Go to your ENS name in the ENS Manager App and scroll down to the bottom and expand Advanced settings. Make sure that the Resolver record there is set to either of these contract addresses:

info
  • The new ENS Public Resolver contract: 0x231b0Ee14048e9dCcD1d247744d114a4EB5E8E63
  • The old ENS Public Resolver contract: 0x4976fb03C32e5B8cfe2b6cCB31c09Ba78EBaBa41
    the old ENS Public Resolver contract will continue to work and should not cause any issues.
https://app.ens.domains

If it's unset edit it and enter the ENS Public Resolver: 0x231b0Ee14048e9dCcD1d247744d114a4EB5E8E63

1.2. Set the ETH Address record​

Go to your ENS name in the ENS Manager App and scroll down to the Addresses section

https://app.ens.domains

Click Add/Edit Record and enter your wallet address into the ETH Address record field.

https://app.ens.domains

Then scroll down and click Confirm at the bottom of the address section.

https://app.ens.domains

2. Set the Primary Name​

Prerequisites
  • The ENS name must be configured with a Resolver record for the Addresses-section to appear.
  • The ETH Address record of the ENS name must first point to the wallet you want to set the Primary Name on

If either of these aren't set, please follow the instructions in Prerequisites

Go to the ENS Manager App and connect your wallet.

Click My Account on the upper right hand side to go to your Account page. Select an ENS name from the Primary drop-down list, click Save and confirm the transaction in your wallet.

https://app.ens.domains

3. Verify that your Primary name works​

Visit a few different services and verify that your Primary name is working correctly:

The ENS Manager App will show your Primary name and the Avatar set on it in the top-right corner, along with your wallet address.

https://app.ens.domains