---
title: "Set a primary ENS name"
description: "Configure reverse resolution for an address on L1 and supported L2s."
canonical: "https://ens.tools/docs/primary-name"
section: "Manage names"
stability: "stable"
version: "Web app and unsigned plan helpers"
verifiedAt: "2026-07-29"
owner: "ENS.Tools Portfolio"
---

# Set a primary ENS name

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

## Overview

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.

## What this covers

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

## 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

## How to use it

1. **Choose a name you control.** The name should resolve forward to the address whose primary name you are setting.
2. **Select the chain context.** L1 and supported L2 reverse records are separate. Set only the contexts you intend.
3. **Sign and verify both directions.** After confirmation, check address-to-name and name-to-address results.

## Related guides

- [Public profiles and share cards](https://ens.tools/docs/public-profile)
- [ENS lookup and domain details](https://ens.tools/docs/lookup-domain-details)
- [Safety, simulation, and signing](https://ens.tools/docs/safety-and-signing)