cPanel’s Zone Editor lets you manage your domain’s DNS records. This article looks at how to use the Zone Editor to edit, remove, add and reset DNS records. Other pages in this section of the knowledgebase deal with DNS in general and specific DNS records:
The Zone Editor’s main page lists all domains on your account. Next to each domain are shortcuts to quickly add an A, CNAME or MX record, and you can click the Manage link to view all existing DNS records.
Image: We are going to manage the DNS for example.net.
When you select the Manage link the editor shows all the DNS records in the zone. You can filter the records by record type. For instance, in the below screenshot I clicked the MX button to only list MX records.
Image: filtering MX records.
For each record you got two possible actions: edit and delete. Obviously, the “Edit” option let’s you change a record’s values. You can for instance change the name of the main MX record to mail.example.net.
Image: editing an MX records.
You can click the Save Record button to save the change or click Cancel to return to the overview.
If you look carefully at the previous images you see that the record name (example.net.) ends with a full stop. The trailing dot has a similar meaning to the full stop in a sentence: it indicates where the record ends. In DNS terms, the name is “fully qualified”.
Without the full stop the zone’s domain name is automatically appended. In other words, the record name example.net would be changed to example.net.example.net.. That name wouldn’t resolve and prevent website and/or email traffic from reaching its destination.
Confusingly, in cPanel’s Zone Editor the trailing dot is only shown in the Name column, and not in the Record column. This looks wrong, in particular when a record’s value points to an external domain. In the below example I am changing the MX record for example.net. so that it points to st2.mx.email-filter.net. (which is our spam filter). The destination should have a trailing dot but cPanel is not having it – the error message says that the name should not end with a full stop.
Image: cPanel’s Zone Editor says that the domain must have a valid TLD label.
As any domain name in the record column should always be a fully qualified name the Zone Editor automatically adds the trailing dot in the background. Similarly, cPanel automatically adds the trailing dot if you add a record for your domain name and forget the full stop. In other words, the Zone Editor helps prevent common “trailing dot issues”.
You can add a new DNS record via the blue Add Record button. In the below example I am adding a TXT record for the domain _acme-challenge.example.net.:
Image: adding a TXT record.
Although there is no “undo” button for DNS records you add, change or delete, it is possible to revert a DNS zone to its default state. This is a useful option if you have made a number of changes that you want to undo.
When you reset a DNS zone the system should still keep any TXT records you have added. However, it is strongly recommended to make a note of all the records in the zone before you hit the reset button. Taking a screenshot of the full page can be real life-saver, as any customisations will be lost when you reset a DNS zone.
The option to reset a DNS zone is hidden under the cog icon, to the right of the Actions header.
Image: resetting a DNS zone will revert the zone to the default state.
It is worth repeating that any records you added will be removed and that any records you changed will be reset. For instance, in the above screenshot you can see the MX record we changed earlier. When the zone is reset the destination of the MX record is reset to the default value (that is, it will point to example.net).
A domain’s name servers define where the DNS zone for a domain is hosted. That means that the records shown in the Zone Editor are only used if the your domain’s name servers are pointing to the server that is hosting your account.
Name servers are managed via your domain registrar’s control panel. If your domain is registered with us then you can view and change the name servers via your billing account:
In the below example the name servers point to ns5.catalyst2.net and ns6.catalyst2.net, which are the name servers for our shared Linux servers. The name servers for your domain may be different.
Image: the name servers for the domain example.net.
The current name servers for your domain are also stored in the public Whois database. You can view this information online:
When you change a DNS record it takes roughly 24 hours for the change to propagate to all DNS servers on the internet. Usually it takes less time, but occasionally it takes longer. This means that you will not instantly see the result of DNS changes you make. For instance, for this article I changed where mail for example.net is routed to. While that change is propagating incoming emails may be sent to either the old or new mail server.
The TTL value shown in the Zone Editor can, in theory, help speed up the DNS resolution. The default value is 14400 seconds, which means that DNS servers should check if the DNS zone has changed every 4 hours. You can lower the value to, say, 3600 some time before you make your DNS changes. However, there is no guarantee that DNS servers will honour lower values. In fact, they almost certainly won’t.
As mentioned, the full stop at the end of the domain name is important. cPanel is quite smart when it comes to preventing trailing dot issues but if you are managing your DNS elsewhere then this may cause issues. If you suspect that a DNS change you made has gone wrong, there are various tools you can use to check your DNS records. Alternatively, please feel free to ask us to check the DNS for you.