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.
Subnames only come with a manager role; ownership is tied to the parent name.
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 the Manager 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
Who can delete a subname?
Who can delete a subname?
A subname can be deleted by its manager.If the current manager is different, the parent can first change the manager back to themself and then proceed to delete the subname.
Why don't i have a manager?
Why don't i have a manager?
Names wrapped in the Name Wrapper do not have a separate Manager field. The traditional Manager role is merged into the Owner role on the ERC-1155 token contract. Unwrapped names have both an Owner and a Manager. Subnames, whether wrapped or unwrapped, only have a Manager — they never have an Owner. See: Name Wrapper Overview
What subnames can i create with the namewrapper contract?
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:
Can I wrap a subname if the parent is not wrapped?
Can I wrap a subname if the parent is not wrapped?
Yes. However, you’ll need to wrap the parent name in order to benefit from Namewrapper fuses on the subname.
Can I unwrap a subname?
Can I unwrap a subname?
Yes, you can unwrap a subname, provided the CANNOT_UNWRAP
fuse has not been burned on that subname.
If I create subnames on a wrapped parent name, are they wrapped or unwrapped?
If I create subnames on a wrapped parent name, are they wrapped or unwrapped?
A wrapped parent creates wrapped subnames, and an unwrapped parent creates unwrapped subnames. Wrapping or unwrapping a parent does not automatically change the status of its existing subnames - their state remains as it was.
What happens to subnames if I transfer the parent name?
What happens to subnames if I transfer the parent name?
Subnames remain linked to their parent name. When a parent name is transferred, the new parent owner also gains control over its subnames. However, subnames retain their existing profile records and manager as they were at the time the parent was transferred. The new parent owner can reassign the manager to themselves, update records, or delete the subname if needed.
The exception is for wrapped names, where if certain fuses (such as PARENT_CANNOT_CONTROL
) have been burned, the parent may not have permission to modify or delete the subname. In all cases, subnames do not automatically update when the parent name is transferred and retain their existing profile records and manager.