Records & resolution

Every .gwei 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.

Onchain avatars

GNS Domains stores your name’s image directly onchain: the image itself (an SVG) is saved as a data URI inside the avatar text record. There is no IPFS pin that can expire and no gateway that can go down; as long as Ethereum exists, your avatar renders.

From the manage page you can:

• Generate a branded card unique to your name (its design is derived deterministically from the name’s hash);
• Upload your own SVG, which is sanitized and optimized in your browser;
• Convert a simple image (logo, pixel art) to SVG. Photographs will not fit onchain.

Because storage costs gas, the size meter shows the exact cost estimate before you confirm. Images are capped at 8 KB; the generated card is around 2 KB.

Note: the NFT image shown by marketplaces is generated by the contract itself and cannot be changed; the avatar record is the image this site and compatible apps display.

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.gwei.domains. See IPFS websites.