Good to Know
Updating Header is a gas only transaction requiring ETH on Ethereum Mainnet
The "upload image" method supports gasless changes after the first time.
The Manager-role can add the header to the a name.
For wrapped names, the Manager role is merged into the Owner-role, which can update records.
Header can be added during a registration, subname creation, and at any time using the Edit Profile button.
Ways to set your Header
There are two methods to set your Header
Upload Image from your device
Enter Manually a header url
A) Method: Upload Image
To upload an image file from your computer, click Upload Image and select an image file from your computer to upload.
Gasless Header changes with 'Upload Image'
The Upload Image option allows for gasless header changes after the first transaction. This means that you initiate a gas only transaction the first time, then can use upload image to gaslessly change your header as many times as you want in future (for the same name in the same wallet).
The source code for the upload image service is found here:
B) Enter Manually
GIFs
GIFs can work for ENS header, but large file sizes might cause issues with some clients or websites, leading to failed or prolonged loading times.
Additionally, it's important to note that using the "upload image" option will automatically convert images to JPG format. If you're looking to use GIFs or SVGs for your header, you should upload them to a separate image hosting service that provides a direct public URL. You can then manually paste the url in the header field through Records-tab.
How to Set the Header (Upload Image)
1. Select Edit Profile
Go to the ENS App, connect your wallet, Open the profile tab of your name, then click Edit Profile.
2. Click the Add header button
Click the "Add header" button and select from the sub-menu Upload Image. Upload Image allows you to select an image file from your computer to upload.
3. Select, Resize & Sign to Upload
Use the slider to crop the image to your liking and click Continue. Then click Sign and Upload to start the upload process. Your wallet will prompt you to sign.
Note that this only saves them locally, and the next steps are required to publish it to the blockchain.
4. Confirm the transaction
When ready, Click Save, then Open Wallet and confirm the transaction. Once complete, the header will display.
How to Set the Header (Enter Header URL)
To set Header using an image hosting service, you will add a url.
1. Select Edit Profile
Go to the ENS App, connect your wallet, Open the profile tab of your name, then click Edit Profile.
2. Click the Add header button
Click the "Add header" button and select from the sub-menu Enter Manually. Upload Image allows you to select an image file from your computer to upload.
4. Enter header URL
Input your Header URL, then click save.
4. Confirm the transaction
When ready, Click Save again, then Open Wallet and confirm the transaction. Once complete, the header will display.
FAQ
My Header isn't showing on third party sites?
My Header isn't showing on third party sites?
Header changes will update instantly on the ENS App, however some third party sites may take time to upload on their end. In some cases you can Refresh Metadata on these site. Reach out to that project/wallet/apps support directly if you run into issues.
What are Gasless Header changes?
What are Gasless Header changes?
The Upload Image option allows for gasless header changes after the first transaction. This means that you initiate a gas only transaction the first time, then can use upload image to gaslessly change your header as many times as you want in future (for the same name in the same wallet). The source code for the upload image service is found here:
Can i use a GIF?
Can i use a GIF?
GIFs can work for ENS header, but large file sizes might cause issues with some clients or websites, leading to failed or prolonged loading times.
Additionally, it's important to note that using the "upload image" option will automatically convert images to JPG format. If you're looking to use GIFs or SVGs for your header, you should upload them to a separate image hosting service that provides a direct public URL. You can then manually paste the url in the header field through Records-tab.