How to Keep ENS Records in Sync
An ENS name can be yours, working, and still refuse to do what you ask of it. The usual reason is that ownership and management have drifted apart, which happens more often than most holders expect.
What sync actually means
Every name has an owner and a manager. The owner holds the name and may transfer ownership. The manager, sometimes called the controller, is permitted to make changes such as setting records.
A name is in sync when both sit where you expect them to. It is out of sync when they do not, which in practice means the wallet you are using cannot edit a name you legitimately own.
How names drift out of sync
- Transferring ownership without updating the manager. Ownership moves, the manager does not, and the new owner cannot edit records.
- Setting a manager from a wallet you later stopped using. Nothing breaks immediately, and nothing works when you come back.
- Buying on the secondary market. A purchased name can arrive with a manager left over from the previous holder.
- Importing a name into a new tool. The tool may set up ownership and leave the manager as it found it.
For what the manager is actually able to change, see ENS resolvers and records explained. The roles themselves are set out in the registry, registrar and controller guide.
How to spot it
The symptoms are consistent. A name does not appear in the portfolio view of a wallet that plainly owns it. A record change fails or appears to succeed without effect. A name resolves to an address you have since changed.
The reliable check is to look at both roles for every name you hold. Where the owner is a wallet you control but the manager is not, that name is out of sync.
Fixing it
Where you still hold ownership, the fix is to reassign the manager to the wallet you want managing records. This is a single transaction per name, which is why bulk handling matters on a portfolio.
Resetting the manager does not require deleting records. Clearing records is destructive and separate, and should only be done when you actually intend to remove them.
Expired names are not out of sync
A name in its grace period or in the premium phase (see the grace period timetable) cannot be edited in the normal way until it is renewed. Treating those as out of sync produces noise and wastes transactions. A sensible sync check excludes expired, grace and premium names and looks only at live registrations.
Why this matters more with time
Sync problems accumulate. Every wallet you stop using, every name you buy, and every transfer adds a chance for owner and manager to separate. A holder who has been in ENS for several years is far more likely to have an out of sync name than someone who registered one name last month.
The practical habit is to review the full set periodically, in one place, rather than noticing problems one at a time when a record change fails.
Next steps
Browse the ENS learning hub for related guides. Read resolvers and records explained for what the manager is actually permitted to change, or managing an ENS portfolio for handling several names at once.
Sources
- ENS Documentation - owner, manager and controller roles
- ENS Documentation - registry and resolver permissions
- ENS Documentation - wrapped names and expiry behaviour