Records & resolution

Every .ether name is also a resolver: it stores the data other apps look up when they encounter your name. All records are set by the name’s owner, live directly in the contract, and are wiped automatically if the name expires and is re-registered by someone else.

Address record

The most important record: which address the name points at.

• Set it from the Records tab of your name’s manage page.
• If you never set it, resolution falls back to the owner of the name, so a freshly registered name resolves to your wallet with zero setup.
• Multi-chain addresses are supported through standard coin types; the address record for Ethereum is coin type 60.

Text records

Free-form key/value pairs following the convention most wallets and apps already understand:

You can set any custom key you like; the table above is just what most apps read.

Avatars

Every name has a default card: a branded registry certificate derived deterministically from the name. It is drawn onchain by the NameCard contract (and byte-identically by this site), so a name with no avatar record always shows its card: nothing to pin, nothing to go offline.

To use your own image, upload it to an IPFS provider under your own account (Pinata, Storacha, Filebase), then paste its CID on the manage page. Only the short ipfs:// link is stored onchain, so the transaction stays cheap. Keeping the image online is up to you: it shows for as long as the CID stays pinned, and because it is content-addressed, anyone can re-pin it anywhere. If it ever goes offline, or the record is empty, this site falls back to the default card.

Note: the NFT image shown by marketplaces is this same certificate, rendered onchain by the NameCard contract, and cannot be changed; the avatar record is the image this site and compatible apps display instead.

Primary name (reverse resolution)

Records map names to data. The primary name maps your address back to a name: it is what apps display instead of 0xd8dA…6045.

• Set any name you own as your primary from its manage page.
• The contract only honors it while the name is active and still resolves to your address, so a stale or sold name can never impersonate you.
• You can clear or change it at any time.

Website (contenthash)

The contenthash record points your name at decentralized content, typically an IPFS CID. Once set, your site is reachable through the community gateway at https://yourname.ipfs.cc. See IPFS websites.