Skip to main content

What is ENS?

What ENS is and what a name does: receive crypto, carry one profile across apps, host a decentralised site, and how to register one.

ENS is the Ethereum Name Service. It swaps a long wallet address like 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 for something you can read and say out loud, like vitalik.eth.

You register a name, point it at your wallet, and anyone who knows the name can send you crypto or look up your profile without ever handling the full address.


Money: receive crypto under a readable name

Replace your wallet's 0x address with yourname.eth. Your name stores an ETH Address record pointing at your wallet, and you can add address records for other chains too, such as Bitcoin and Solana. One name can cover wallets on several networks.

See Add wallet addresses for other chains (Testnet: Add wallet addresses for other chains). To make yourname.eth appear in apps instead of your 0x address, set your primary name (Testnet: Set your primary name).


Identity: one profile across every app

Think of your name as a container. What sits inside are records: your avatar, banner, social handles, website, and any custom text you add. Wallets and apps that read ENS pick this profile up when you connect, so you don't need a separate profile per service.

What lives on your profile:

  • Avatar and banner: uploaded images or NFTs.

  • Social handles: X, Discord, Telegram and others. Some platforms verify the link back to your ENS name.

  • Wallet addresses: for receiving payments on Ethereum and other chains.

  • Decentralised website: set through the Content Hash record.

  • Custom records: text records for anything app-specific.

Some apps also support Sign-In with Ethereum, so you can sign in with your ENS name instead of a username and password.


Web: host a decentralised website

Point yourname.eth at a website hosted on a decentralised network, using the Content Hash record. Both the name and the hosting then sit outside any single company's servers.

Supported networks:

Network

What it is

IPFS

Peer-to-peer file system, the most common choice.

Swarm

Ethereum-aligned decentralised storage.

Arweave

Permanent storage.

Tor

Anonymous hidden services.

To set this up, set the Content Hash record on your name. See Add a decentralised website to your ENS name.


Subnames: hand out names under your own

Any name you own can issue subnames, like pay.yourname.eth or alice.yourteam.eth. Each subname carries its own records and can point at a different wallet. Communities use them to give members a shared identity, and you can use them to label your own separate wallets.


How do I get a .eth name?

Register a .eth name at app.ens.domains. Search for the name you want; if it's available, you can register it there and then. You pay per year of registration, in ETH on Ethereum Mainnet, plus gas. After that the name is yours to manage: edit its records, transfer it, or extend it before it expires.

On ENSv2 Testnet the apps are app.ens.dev and explorer.ens.dev, both on Sepolia. Registration is annual there too, but you pay in USD stablecoins (such as USDC) plus a small amount of ETH for gas. See What is ENS Explorer? for the companion tool.


Common questions

How does ENS work?

When you register a .eth name, two things are recorded onchain. First, the ENS registry marks you as the owner. Second, the registration sets a resolver. That's a small contract holding the records attached to your name: your ETH address, avatar, social links, and anything else you add.

When someone sends crypto using your .eth name, their wallet asks ENS which address the name points to. The resolver answers, and the transaction goes to the right place. You can change your records whenever you like, and the name stays the same even when the wallet behind it changes.

Lookups run both ways. A forward lookup goes name to address: typing yourname.eth into a wallet finds your ETH address. A reverse lookup goes the other way: an app sees your address and checks which name is set as primary for it.

What are the Registry and the Registrar?

Two contracts with similar names do the bookkeeping behind every name.

The registry is ENS's ledger. For each name, identified internally by a hash called its namehash, it stores who owns the name and which resolver holds its records. It stores nothing else: your address, avatar and other records live in the resolver. In ENSv2 the registry is a tree of contracts (a root registry, one for .eth, and one for each name that issues subnames) rather than a single contract.

A registrar controls who may register names under a TLD. The .eth registrar decides whether yourname.eth is available, takes the registration fee, and issues the ownership NFT, then records the result in the registry. In short: the registrar decides who may own a name; the registry records who currently does.

Who runs ENS?

ENS is a decentralised protocol governed by the ENS DAO. No single company owns or controls it. Names are held onchain as NFTs, and a name stays yours for as long as you keep it registered.

See Official ENS websites, apps, and tools for the DAO's forum, voting and delegation links. For how ENS began, see The story of ENS.

Is ENS the same as DNS?

The job is similar (both turn names into addresses) but the machinery differs. DNS is run centrally through registries, registrars and authoritative servers. ENS is onchain: names are managed by smart contracts, ownership is an NFT, and any app can read the records straight from public contracts.

ENS also works with DNS names: a domain you already own, such as a .com or .xyz, can be used as an ENS name. In the ENS App and ENS Explorer, .eth names and their onchain subnames are what you register and manage. See What TLDs are supported?.

Do I have to use my .eth name everywhere?

No. Apps that support ENS show your name once you've set one as primary. Apps that don't will keep showing the wallet address. Most major wallets support it, but not every app does.

Why do apps still show my address instead of my name?

Owning a name doesn't tell other apps to use it. You have to set it as your primary name: the reverse-lookup record that tells apps which name to show for your wallet. You can change which name is primary at any time. See set your primary name (Testnet: Set your primary name).

Is any of this private?

The records you set are public. Anyone can read them straight from the contracts, and anyone can see which address a name points at. Don't put anything on a record you wouldn't publish. See Is my ENS name private?.

What's the difference between ENSv1 and ENSv2?

ENSv1 is the version of ENS running on Ethereum Mainnet. Every .eth name registered at app.ens.domains is an ENSv1 name.

ENSv2 rebuilds the protocol from the ground up, so each name is more powerful, easier to manage and more secure. The biggest change is that each name can have its own registry, which is what gives it subnames and finer control over who can do what.

The test contracts sit on the Sepolia test network, where you can also try the two apps, app.ens.dev and explorer.ens.dev. Sepolia names are test names: they are paid for with test funds and do not carry over to Ethereum Mainnet.

Where do I learn more?

The full documentation lives at docs.ens.domains. For announcements and community chat, see the ENS blog and the ENS Discord. Protocol specs are the ENSIPs, listed in the docs. For a question about a name you own, the support team here is the fastest route to a human.

Did this answer your question?