Skip to main content

Glossary: What do these ENS words mean?

Quick definitions for names, records, roles, and the buttons you'll meet in the ENS App.

A quick reference for the words you'll see in the ENS App and across the docs.

Names

ENS (Ethereum Name Service)

A naming system on Ethereum. ENS turns readable names like alice.eth into wallet addresses, websites, and other data that apps can read.

Name / ENS name

A readable identifier registered on ENS. Most ENS names end in .eth (e.g. myname.eth). DNS names like example.com can also be imported into ENS.

Subname

A name created under a parent name. pay.alice.eth is a subname of alice.eth. The parent name's Manager creates subnames, and each subname has its own records. Sometimes called a subdomain.

Label

A single segment of a name, separated by dots. In pay.alice.eth, the labels are pay, alice, and eth.

TLD (Top-Level Domain)

A name at the top of the naming hierarchy: .eth, .com, .xyz, and so on.

2LD (Second-Level Name)

A name directly under a TLD. alice.eth and example.com are both second-level names.


Roles

Owner

The wallet that owns a name. The Owner can transfer the name, recover the Manager role, and has final control. Transfer the Owner role and you lose the name.

Manager

The wallet that looks after a name's records. It can change the ETH Address, set text records, create subnames and set the primary name, but it cannot transfer the name. This lets you hand someone day-to-day control while you keep ownership.


Registration and expiry

Register

Claiming a .eth name that nobody holds. You choose the term: 28 days at the least, with no upper limit. A name is rented rather than bought, so you renew it to keep it.

Renew (extend)

Paying to add more time to a name. The time is always added to the name's expiry date, not to today's date, so you never lose days you have already paid for. Anyone can renew a name, and renewing never changes who owns it.

Expiration date

The date a .eth name's registration ends. Extend before this date to keep the name.

Grace period

The 90 days after a .eth name expires. During those 90 days anyone can renew the name at the normal price, and nobody else can register it. Renewing it never changes who owns it. The name keeps working in apps, but the ENS App shows it as expired. On ENSv2 the grace period is 28 days, and upgrading adds 62 free days, so the end date works out the same.

Temporary premium

An extra fee charged on top of the normal price for the first 21 days after a name leaves its grace period. It starts at $100 million and falls to $0 across those 21 days. A name in this window has to be registered as new rather than renewed, and anyone can register it. On ENSv2 the same window is called Price Cooldown. See ENS Pricing for the full lifecycle.


ENSv2

The next generation of ENS. It runs on the Sepolia test network today, so names registered on it do not carry across to Ethereum Mainnet.

Upgrade

Moving a name from ENSv1 to ENSv2. Each name you upgrade gets 62 free days added to its registration. A name in its grace period has to be renewed first, then upgraded.


Records and resolution

Records

The data stored against an ENS name:

  • Other addresses: addresses on other chains (Bitcoin, Solana, and many more).

  • Content hash — a link to a decentralised website (IPFS, Arweave, Swarm).

  • Text records — free-form data like avatar, email, description, or social handles.

The ETH Address and primary name are records too; each has its own entry in this list.

ETH Address

The wallet your name points at. Apps read this record to know which wallet to show or send funds to when someone types yourname.eth. Set it from Edit ProfileAddresses, or from Edit Roles on the Ownership tab.

Primary name

The ENS name a wallet has set to represent itself. When wallets and dApps show yourname.eth instead of a 0x address, they're reading the primary name. Each address can have one primary name per network. See Set your primary name.

Avatar

A text record that sets the profile image for your ENS name. Can be an uploaded image or an NFT you own.

Registrar

The contract that registers .eth names and takes renewal payments. It holds each name's expiry date.

Registry

The contract that records who owns which name. On ENSv2 you can give your own name a subregistry, which is what lets it have subnames.

Resolver

The contract that holds your name's records and hands them back when an app asks for them. Most names use the Public Resolver. You only need to change it if you are troubleshooting.

What looking up a name means

Two different lookups sit behind this. When an app turns alice.eth into an address, it is reading the name's records. When an app shows alice.eth for a connected wallet, it is reading that wallet's primary name. Wallets and apps that read ENS live pick up a change straight away; sites that cache can take a day or two.


Wrapped names

Wrapped name

A name deposited into the Name Wrapper contract. Wrapped names can have permissions set via fuses.

Unwrapped name

A name in its original state, not in the Name Wrapper. Older .eth names can be unwrapped.

Fuses

Permission settings on a wrapped name that restrict what the Manager can do. Some fuses are permanent once burned.


DNS names

DNS (Domain Name System)

The traditional internet naming system (e.g. example.com). ENS can import DNS names so they work onchain too.

DNSSEC (DNS Security Extensions)

A way of adding a digital signature to DNS records. You need it to import a DNS name into ENS, because the signature is what proves the domain is yours.

Onchain DNS name

A DNS name imported and recorded on Ethereum. Updates cost gas.

Offchain DNS name (gasless)

A DNS name whose ENS records live in its own DNS TXT records rather than onchain. Nothing is written to Ethereum, so it costs nothing to set up or change.


Networks

L1 (Layer 1)

Ethereum Mainnet, where .eth names are registered and where ownership lives.

L2 (Layer 2)

Scaling networks built on Ethereum, like Optimism, Arbitrum, and Base. An ENS name can resolve to addresses on L2s and can carry a different primary name on each network.

Gas

The fee a network charges to process a transaction. You pay it on whichever chain the transaction runs on, and it rises and falls with how busy that chain is.

CCIP-Read (offchain resolution)

The standard that lets a name's records be stored somewhere other than Ethereum Mainnet, such as an L2 or a server, and still be read as part of the name. It is what makes gasless records possible.


Buttons in the ENS App

Common buttons you'll see on a name's page:

  • Extend — renew a name's registration and push back the expiration date.

  • Edit Profile — add, update, or remove records (addresses, social links, avatar, and more).

  • Edit Roles — change the Owner, Manager, or ETH Address for a name.

  • Set as Primary Name — make this name represent your wallet across apps.

  • Send — transfer the name to another wallet.

  • + New Subname — create a subname under this name.

  • Wrap Name / Unwrap Name — move the name into or out of the Name Wrapper.

  • Set Reminder — add a calendar reminder for the name's expiry date.

  • Sync Manager — set the Manager to match the Owner address. Useful after a transfer.

Did this answer your question?