Skip to main content

How to Wrap and Unwrap a name

Wrap and Unwrap a name in the Namewrapper contract

Updated over 2 weeks ago

⚠ Before You Begin

With ENSv2 on the horizon, we suggest waiting before burning fuses to lock names. Locked names in the Name Wrapper will only be migratable to L1, so if you want to be able to issue trustless subnames on Namechain your best option is to wait until namechain is live. Learn more: ENSv2 Hub


Good to Know

  • Only the owner can wrap or unwrap a name.

  • Wrapping and unwrapping are gas only transactions requiring ETH on Ethereum Mainnet


The Namewrapper is a contract for ENS that allows you to "wrap" any ENS name into a ERC-1155 NFT, and enables more functionality to subnames. Read more in the Name Wrapper Overview

Some names registered on ENS APP are automatically wrapped. If you have a wrapped name you can also unwrap it, provided you have not burnt the fuse CANNOT_UNWRAP.


How to Wrap your Name

1. Select Wrap Name

Go to the ENS App, connect your wallet, Open the More tab of your name, then click Wrap Name.

2. Review features, and Confirm the transaction

Review the new features, then click Open Wallet and confirm the transaction. Once complete, your name is wrapped.


How to Unwrap your Name

1. Select Unwrap

Go to the ENS App, connect your wallet, Open the More tab of your name, then click Unwrap Name.

2. Review features, and Confirm the transaction

Click Open Wallet and confirm the transaction. Once complete, your name is unwrapped.


FAQ

Why is my name wrapped?

Some names registered on ENS App are automatically wrapped.

If i wrap my name can i unwrap it later?

If you have a wrapped name you can also unwrap it, provided you have not burnt the fuse CANNOT_UNWRAP. See Fuses

If i unwrap my name, can i re-wrap it again?

Yes. You can re-wrap your name.

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?

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?

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.

If I wrap or unwrap my name, will I lose my profile records?

Wrapping or unwrapping does not remove existing profile records such as text records, avatars, or addresses. However, when a resolver update is applied during wrapping or unwrapping, it will clear your existing profile records. The ENS app automatically applies the latest public resolver, which can cause this. You can re-add your profile records afterwards to the new resolver.

Did this answer your question?