How to set up an ENS Subdomain

In this tutorial we will go through the steps to set up an ENS subdomain

Creating a subdomain is free, but you will be spending some ETH for gas fees to update records!

What is a subdomain?

A subdomain is a special kind of domain that sits within a larger ENS domain. It behaves like an ENS domain, and has similar records as well.

To put it differently, it's a method to create sub-names to a larger ENS name. For example you could have poap.phinominal.eth to keep all your POAPs, and another sub-name to store other stuff. It's up to your imagination to create as many sub-names as you like.

Step 1

Navigate to your ENS name and select the 'Subdomain' section:

Click on 'Add Subdomain' and a text input will appear. Enter a name for your subdomain and press 'Save' when ready.

Step 2

Confirm the transaction and wait till it's confirmed on the blockchain

Step 3

Once the transaction is completed, you will be able to find your subdomain in the list.

From here you can either:

  1. Manage the records for the subdomain (click on the name)

  2. Delete the subdomain (click on the trash can on the right)

Managing Subdomain Records

As you can see, the list of records for a subdomain is similar to the main domain. You can also set a subdomain to this subdomain (e.g. very.extra.phinominal.eth).

Refer to How to Manage ENS records to manage the subdomain records.


The following FAQ is verbatim from

Why are some of my subdomains shown as a jumble of characters?

ENS names are stored as a hash on-chain so we have to decode the name using a list of possible names, and it shows in the hashed format if we don't have it on our list. You can still access and manage the name if you search for the name directly in the search bar.

How do I transfer my name?

For a ".eth" name, transfer both the Registrant and the Controller to the new Ethereum account. Since ".eth" names are ERC721 compliant NFTs, you can change the Registrant by simply transferring the NFT from any NFT compliant wallet/marketplace as well.

Note that transferring the ownership (aka the Registrant) of the name does not change the controller nor records, so the recipient may need to update them once received. If the recipient is not experienced or you prefer your address not to be associated to the transferring names, it may be a good idea for you to set the ETH Address record to their Ethereum address, set the controller, then transfer the name.

For subdomains, there are no registrants unless the subdomain is customised to be ERC721 compliant. Simply set the controller to the new address (after setting the record to the new address).

Last updated