Step-by-Step Guide to Migrating Your .Eth Name to the New ENS Registrar

Brantly Millegan
May 4, 2019 · 4 min read
Image for post
Image for post

The permanent Ethereum Name Service (ENS) registrar has launched!

This means you have one year — until May 4th, 2020 — to migrate your .eth name to the new registrar.

All names from the old registrar that are not migrated to the new registrar by May 4th, 2020 will be automatically released for anyone to register again.

To migrate, we recommend using our official ENS Manager app. When you migrate, you will get your previous registration deposit back and your first year of rent for free. After that first year, you will need to pay USD$5/year in ETH to keep the name. You can pay ahead if you’d like; so, e.g., for $50 you can register your name for 10 years.

Below are step-by-step instructions of how to use the Manager to migrate your .eth name:

Step 1: Open your Ethereum-enabled browser

On desktop, this could be Chrome with the extension MetaMask, or the browser Brave with MetaMask (which comes built-in) enabled.

On mobile, this could be Coinbase Wallet, Status, or another mobile Ethereum browser.

This guide will assume you are using Meta Mask in a desktop browser, but other Ethereum-enabled browsers should work very similarly.

You must be signed in to your Ethereum browser with the same wallet that owns the .eth names you want to migrate, and you must have at least a small amount of ETH in your wallet to pay transaction costs.

Step 2: Navigate to the ENS Manager

In your browser, go to manager.ens.domains.

Tip: Bookmark this page, because it will be the easiest way for you to manage your Ethereum names from now on!

Step 3: Search for your .eth name

Type in to the “Search names” field the .eth name you’d like to migrate, including the “.eth” ending (for example, “yourname.eth”), and click the “Search” button.

Image for post
Image for post

Step 4: Click the “Migrate” button

After clicking the “Migrate” button, you will be asked to confirm a transaction by MetaMask. Click “Confirm.”

The only fee to migrate your name is an Ethereum transaction fee, which should be very small. You will not be able to complete this step without some ETH in your wallet to pay the transaction fee.

Image for post
Image for post

Back in the Manager, it should now say “TX PENDING” where the “Migrate” button was. In less than a minute, the transaction should confirm.

…and you’re migrated!

You should now see a message in the middle of the Manager screen that says, “Congratulations on Migrating your domain! You successfully migrated this domain to the new ENS Permanent Registrar. We’ve sent back to you the ETH that you had locked in the older registrar contract.”

Right above that message, you should see “Expiration Date,” followed by a date in YYYY.MM.DD format and a time. It should be about one year from when you migrated. This means that your first year of rent is free!

Image for post
Image for post

Bonus: How to pay ahead on your rent

After migrating, your first year of rent is free. If you’d like to pay the rent for future years now so you won’t have to think about it for a while, you can do that!

On the right side of the Manager page, click the “Renew” button.

Use the “-” and “+” buttons to select the number of years you’d like to add on to your current registration period. To the right of that, you will see how much you will owe in ETH.

Click the new “Renew” button to initiate the process. A box will appear asking you to confirm the action. After you click “Confirm,” a MetaMask box will appear asking you to confirm the transaction.

Once the transaction is confirmed, your “Expiration Date” will reflect what you have paid ahead.

Note: Once you have paid rent, you cannot get it back. For example, if you pay ahead three years, but release your name after two years, you will not get a year’s worth of rent back.

The Ethereum Name Service

News about the Ethereum Name Service (ENS).

Brantly Millegan

Written by

Dir. of Operations at Ethereum Name Service (ens.domains). Personal website and ENS name→ brantly.xyz

The Ethereum Name Service

News about the Ethereum Name Service (ENS) from the team building it. Follow this publication for the latest ENS developments.

Brantly Millegan

Written by

Dir. of Operations at Ethereum Name Service (ens.domains). Personal website and ENS name→ brantly.xyz

The Ethereum Name Service

News about the Ethereum Name Service (ENS) from the team building it. Follow this publication for the latest ENS developments.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store