WebGee DocsDocs
Domains & DNS
Free migration + 30-day money-backSee how

Change the SOA record

What the SOA record holds, why the admin email has no @ sign, and when changing it is worth doing.

Change the Start of Authority record for a DNS zone. Applies to reseller accounts with WHM.

Every DNS zone must have an SOA record — it is required by the DNS standards and is what zone transfers rely on.

An example SOA record

What it holds

FieldMeaning
MNAMEThe primary nameserver for the zone
RNAMEThe administrator's email address
SerialVersion number. Increments on every change
RefreshHow often secondaries check for updates
RetryHow long to wait after a failed check
ExpireHow long secondaries serve the zone if the primary is unreachable
TTLDefault caching time for records in the zone

RNAME has no @ sign and that is correct, not a typo. In an SOA record the @ is replaced by a dot, so admin.example.com means admin@example.com. This confuses people every time they first read one.

A consequence: if the local part itself contains a dot — first.last@example.com — that dot must be escaped as first\.last.example.com.

Change it

  1. Sign in to WHM.
  2. Search for Edit DNS Zone.
  3. Select the domain.
  4. Edit the SOA fields.
  5. Save.

To change the default applied to new zones, use Basic WebHost Manager Setup instead — otherwise you are editing one zone at a time forever.

When it is worth changing

  • RNAME, so abuse and technical notices reach an address you monitor.
  • MNAME, when using custom nameservers.
  • TTL, lowered ahead of a planned migration so changes propagate faster.

The timing values are otherwise best left alone — the defaults are sensible, and short refresh intervals mostly generate needless queries.

The serial must increase on every change. WHM handles this for you, but if you edit a zone file by hand and do not increment it, secondary nameservers will not pick up the change — and nothing will indicate why.

On this page

Hosted elsewhere?

Domains

Register or transfer your domain and manage its DNS in the same place as your hosting.

See plansFree migration