Browse all documentation
Manage names · 6 of 11

Set a primary ENS name

Configure reverse resolution for an address on L1 and supported L2s.

stableWeb app and unsigned plan helpersVerified 2026-07-29Owner: ENS.Tools Portfolio
Open this feature

A primary name maps an address back to an ENS name so wallets and apps can display a human-readable identity. Forward resolution and reverse resolution must agree for trustworthy display.

Current primary-name lookup.
L1 reverse-record preparation.
Supported L2 reverse-name workflows.
Forward-resolution mismatch warnings.
Production contract

Before you run this workflow

Networks

  • Ethereum mainnet

Prerequisites

  • Connected controlling wallet
  • Correct owner, manager, registrant, or resolver authority

Wallet permissions

  • Only the transaction or typed-data signature shown for the selected operation

Expected result

  • A confirmed onchain update with per-name status for bulk operations

Errors and recovery

  • Inspect authority and wrapped-name state
  • Retry only failed items after refreshing chain state
Workflow

How to use it

  1. 1

    Choose a name you control

    The name should resolve forward to the address whose primary name you are setting.

  2. 2

    Select the chain context

    L1 and supported L2 reverse records are separate. Set only the contexts you intend.

  3. 3

    Sign and verify both directions

    After confirmation, check address-to-name and name-to-address results.