Using your Basename

A Basename is a readable name for your address on Base, with a public profile attached.

Checked 25 Oct 2026, 07:14 UTC

Basics

What does a Basename do?

It stands in for your 0x address: people can send to name.base.eth on Base and on other chains whose apps support ENS.

UseWhat it does
PaymentsSend and receive by name instead of a 0x address
Primary nameShows your name in wallets and apps that support Basenames
ProfileBio, avatar, websites, location and skills
Social linksX, GitHub, Farcaster, Telegram and Discord

Sources [1, 2]

How do you set up your Basename?

Set it as your primary name in Profile Management on base.org/names, then fill in your profile.

  1. Connect the wallet that holds the name at base.org/names. No name yet? Check one.
  2. Set it as your primary name.
  3. Add your bio, avatar, links and handles.

Each change is a transaction, and everything you publish is onchain, so leave out anything private.[1, 2]

Advanced

How do apps read a Basename?

Through ENS. Basenames follow ENS's ENSIP-19 standard, so an app finds an address's name on Base with Viem's getEnsName. Much of the .eth guide applies too.

FactDetail
LibraryViem, with Base's coin type
RPCBase says a private RPC provider is necessary
New namesThey can take a while to resolve, while proofs are produced

Sources [3]

Sources (3)

  1. PrimaryBase: Basenames FAQ
  2. PrimaryBase on GitHub: base.org profile fields
  3. PrimaryBase developer docs: Basenames with Wagmi and Viem