You can find our user documentation at

Check out our new API beta site!

Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.44

(Home >> DNS Functions >> Edit MX Entry)


A mail exchanger (MX) entry determines which server receives mail for a domain name. The Edit MX Entry interface allows you to list destination mail servers and designate a priority value to each.

How to edit MX entries

To edit your server's MX entries, perform the following steps:

  1. From the Choose a Domain to Edit menu, select the name of the domain for which you wish to configure MX entries.
  2. Click Edit. A new interface will appear.
  3. Select the type of Email Routing that you wish to use (see Email Routing table below).
  4. Enter the desired settings for each MX entry in the MX Entries section.
  5. Click Save.

Email Routing

You can select any of the following types for your mail exchangers:

Mail exchanger typeDescription
Automatically Detect ConfigurationAllows the system to choose the most appropriate type of email routing based on a query of the MX record. The following criteria determines the mail exchanger that the system chooses:
  • If the lowest priority mail exchanger points to an IP address on this server, the system chooses the Local Mail Exchanger setting.
  • If a mail exchanger with a higher priority points to an IP address on this server, the system chooses the Backup Mail Exchanger setting.
  • If there are no mail exchangers that point to an IP address on this server, the system chooses the Remote Mail Exchanger setting.


Automatic detection is not possible if the MX entry does not resolve (for example, if you mistype a domain name or enter one that does not exist). If the MX entry does not resolve and Email Routing is set to Automatically Detect Configuration, the system will generate a warning and default to the last known setting for Email Routing.

Local Mail ExchangerThe server always accepts mail for the domain.
Backup Mail ExchangerThe server accepts mail for the domain and stores it until a higher priority (lower number) mail server becomes available.
Remote Mail ExchangerThe server will not accept mail for the domain. This entry will always have the lowest priority value.


If you wish for the Automatically Detect Configuration option to consider additional IP addresses as local, you must add them to the list of local IP addresses. You can add IP addresses to the list with WHM's Configure Remote Service IPs interface (Home >> IP Functions >> Configure Remote Service IPs).

MX Entries

You can set the following settings for each MX entry: 

TTLThis integer value specifies the Time to Live. Time to Live indicates how long a particular record remains in memory, in seconds, before it refreshes. This value defaults to 14400.
PriorityThis integer value represents the priority order of the mail server, in relation to other MX entries. The lower the Priority values, the higher the server's priority.
  • The server(s) with the lowest priority values will serve as the primary mail server(s).
  • Servers with higher priority values serve as secondary mail servers.
  • If multiple mail servers have the same priority value, any mail that the system distributes at that priority value will be distributed to those servers randomly.
MX DestinationThe name of the mail server (for example,

Add and delete MX entry fields

To add a new MX entry field, perform the following steps:

  1. Click Add Another MX Entry Field. A new row will appear.
  2. Enter the desired settings.
    • The TTL setting will default to 14400.
    • The Priority setting will default to a value that is 10 higher than the highest priority value of an existing MX entry.
    • The MX Destination setting will be blank.


The bottom MX entry field is always a new MX entry, and displays the label (new) in the furthest right column.

To delete an existing mail exchanger, click Delete next to the desired MX entry.