Skip to main content

How to Create & Delete Subnames

Updated over 2 months ago

Good to Know

  • Creating & deleting subnames are gas only transactions requiring ETH on Ethereum Mainnet

  • The Manager of a name can create and delete subnames.

  • For wrapped names, the Owner role (which includes Manager permissions) handles these actions.

  • Creating a subname has no registration fees – it only costs gas.

  • There’s no limit to how many subnames can be created.

  • Subnames can create their own subnames too.

When you register a .eth name, like ens.eth, you’re registering a second-level domain (2LD) under the top-level domain (TLD) .eth.

Once you own a .eth name, you can create subnames beneath it. For example, the owner of name.eth can create subnames like sub.name.eth. And those subnames can also create subnames like sub2.sub.name.eth, and so on.


How to create a subname

1: Select New subname

Go to the ENS App, connect your wallet, open the Subnames tab of your name, then click + New Subname.

2. Label the new subname

There are no registration fees or limit to the number of Subnames that can be created. It will only cost gas to do.

2. Prepare your profile with address & other profile records

Add any addresses, and profile records that you want on that subname. You can also skip this and complete it after the name is created. See How to Edit Profile. Click Next once you're ready to create the subname.

In this example, an ETH Address has been added

3. Confirm the transaction to create the subname

Click Open Wallet and confirm the transaction. Once complete, the subname will be created.

4. Confirm the transaction to update profile

If you selected to add profile records, a second transaction prompt will appear. Click Open Wallet and confirm the transaction. Once complete, the subname profile is updated.

In this example, the ETH Address is added to the name


How to delete a subname

1. Select Delete Subname

Go to the ENS App, connect your wallet, open the profile tab of your subname, then click Delete subname.

2. Confirm the transaction

Click Open Wallet and confirm the transaction. Once complete, the subname is deleted


FAQ

Why don't i have a manager?

Names wrapped in the name wrapper do not have manager, instead the Manager role is merged into the Owner-role. Names registered via the ENS App are automatically wrapped. More information here.

What subnames can i create with the namewrapper contract?

Subnames can be created on both unwrapped and wrapped names. However the name wrapper contract allows for these subnames to be ERC-1155 NFTs. Read more in the Name Wrapper Overview, and review other articles in the Name Wrapper collection.

For specific subname use cases, utilising the Name Wrapper 🚨permanent fuses🚨, see:

Did this answer your question?