Skip to main content

Set an avatar and header on your ENS name

Set your ENS avatar and header in three clicks — upload an image, paste a URL, or pick an NFT. Upload makes later changes free.

Your avatar is your profile picture; your header is the banner behind it. Both live on your ENS name as records, so any app that reads ENS in real time picks them up.

Pick Upload Image if you want later changes to be free. Pick Enter Manually if you want a GIF or SVG. Pick Select NFT if you want an NFT you already own as your avatar.

Good to know

  • Connect with the Manager, the wallet that controls a name's records. For wrapped names, the Manager role is merged into the Owner role.

  • The first save needs ETH on Ethereum Mainnet for gas; there's no other cost.

  • With Upload Image, later avatar and header changes are free (same name, same wallet). With the other two methods, every change costs gas.

  • The ENS App handles .eth names, their onchain subnames, and DNS names you've imported. For project subnames like base.eth or uni.eth, use the project's own site.


Step 1. Open Edit Profile

Note: onchain changes cost gas — the network fee Ethereum charges to process a transaction. It is paid in ETH from your connected wallet and goes to the network, not to ENS. Your wallet shows the exact fee before you approve.

Go to app.ens.domains and connect your wallet. Search for your name, open the Profile tab, and select Edit Profile.

A name's profile, with Edit profile arrowed
The Edit your profile dialog, with Add avatar and Add header

Step 2. Select Add Avatar or Add Header

Then pick one of the three methods.

Upload Image (recommended for gasless changes)

  1. Select Upload Image.

  2. Choose an image file. Square works best; anything else gets borders.

  3. Crop with the slider.

  4. Select Continue, then Sign and Upload. Your wallet asks you to sign; there's no gas at this step. This saves the image to the ENS-hosted image service.

  5. Once you're done editing your profile, select Save, then Open Wallet and approve. This is the one gas-paying transaction.

The Edit Image dialog, with the crop slider highlighted
The Upload Avatar dialog, with Sign and Upload arrowed
The Edit Image dialog cropping a header to its wide ratio
The Upload Header dialog, with Sign and Upload
The Edit your profile dialog, with the new avatar and header

Why later changes are gasless

The first save writes a record on your name pointing at the ENS image service. Later changes update the image at that pointer without a new transaction. The service is open source (github.com/ensdomains/ens-avatar-worker).

A profile showing the uploaded avatar and header

Enter Manually: paste a URL

Good for GIFs, SVGs, or images already hosted somewhere.

  1. Select Enter Manually.

  2. Paste the image URL.

  3. Select Save, then approve in your wallet.

The Enter manually dialog, asking for an image URL
The Enter Header URL dialog, with its Header URL field

Select NFT (avatar only)

  1. Select Select NFT.

  2. Pick an Ethereum NFT from your wallet.

  3. Select Save, then approve in your wallet.


Step 3. Wait for the transaction

Most confirm in 1–2 blocks (12–24 seconds); busy networks can take longer.

Once it lands, apps that read ENS records in real time show the new image right away.


GIFs and SVGs

Upload Image converts everything to JPG, so you lose the animation or vector. Use Enter Manually instead:

  1. Host the file somewhere that gives a direct public URL.

  2. Paste the URL in Enter Manually.

Keep file sizes small; large files load slowly on some apps.


Troubleshooting

My avatar has borders or is cropped wrong. The image must be square. Re-upload with Upload Image and crop.

My avatar isn't showing on the ENS App. Usually an avatar-metadata issue. Re-set the avatar via Upload Image.

My avatar or header isn't showing on a third-party site. Apps that read ENS in real time show changes right away. Cached sites can take a day or two, and some let you refresh metadata manually. If it persists, contact the site's support.

Did this answer your question?