We're experiencing difficulty. Our engineers are on it. Please check status.mailgun.com for real-time updates.

How Do I Add or Delete a Domain?

Article Preview

    Overview

    Domains are obviously fundamental to begin using your Mailgun account; it's where you're sending from! Aside from the limited testing options provided by an account's sandbox domain, a custom or personal domain is required to send emails through our platform, build a reputation, and establish a professional identity with your emails.

    Check out our article on how to choose a domain if you do not already have a domain. 

    Adding A Domain

    We'll show you how to do this below (there's actually two methods):

    Method 1

    Prefer videos? This video walkthrough demonstrates adding a domain to Mailgun's system and configuring that domain's DNS records within a DNS hosting provider.

    Otherwise, follow these steps to add your domain.

    1. First, log in to the Mailgun Control Panel (if you have not already done so).
    2. Then, within the left-hand navigation pane, click the Sending option to expand its list of suboptions.
    3. Next, click the Domains suboption.
      MG.SideNavigation.png
    4. Click the Add New Domain** button.
      • ** Note: Accounts on a Free plan (with no credit card on file) will not see a button on your account to add a domain. Accounts on the Free plan are limited to using only the default sandbox domain with Authorized Recipients. Upgrading the account is required to add new domains.
        SendingOptionDomainSuboptionAddDomain.png
    5. Enter your Domain Name (it cannot be renamed later) and configure the additional options.
      • Region - where your domain will reside: US or EU.
      • Create DKIM Authority - if presented, this option should generally remain checked by default.
      • DKIM Length - a longer DKIM key will make spoofing your emails by malicious spammers more difficult. 1024-bit is selected by default, but 2048-bit can be used as well.
      • Note: Some DNS providers may have an issue with 2048-bit DKIM keys, as they produce a string longer than 255 characters (exceeding the maximum character limit for a DNS entry). If you run into this issue, please work with your DNS provider to configure the 2048-bit key within their system, if possible.
        SendingOptionDomainSuboptionAddDomainPage.png
    6. Once your domain name is entered and the options are set, click the Add Domain button to save your new domain.

    SPECIAL NOTE: It is not possible to add a domain if (1) your account is disabled, (2) another domain on your account is disabled, (3) your account already has 1,000 domains, (4) your account is on the Free plan, or (5) your user's role permissions on the account are neither "Admin" nor "Developer".

    The next page you see after adding the domain displays the DNS records required for your domain to be verified with Mailgun. For a domain to be verified within Mailgun, you must configure the required Mailgun DNS records within your DNS provider's system. If you need assistance with this, please see this article for more details. This information is also available in the Domains section of the control panel by clicking on a specific domain name
    DomainVerificationAfterNewDomain.png
     

    Method 2

    If you would like to add a domain using the domains API, you can find more information in our documentation.

    Deleting A Domain

    What if you no longer use a domain or if there is a typo in the domain name?  Thankfully, it can be deleted. We'll show you how to do this below (there's actually three methods):

    Method 1

    1. First, log in to the Mailgun Control Panel (if you have not already done so).
    2. Then, within the left-hand navigation pane, click the Sending option.
      MG.SideNavigation.png
    3. Next, click the gear icon, which is located on the right-end of the row for the domain you wish to delete.
      SendingOptionDomainsSuboptionDomainList.png
    4. Select the Clear domain queue option and confirm your intention to clear the queue by clicking the Clear queue button in the pop-up modal.
      • Note: if the domain is a sandbox domain (i.e. one that looks like this sandbox9e987639aa.mailgun.org), these system-generated testing domains cannot be deleted from your account. 
      • Note: if your user's permissions are not "Admin" or "Developer", you cannot delete the domain from your account.
        SendingOptionDomainsSuboptionCogOptions.pngSendingOptionDomainListCogDelete.png

    SPECIAL NOTE: It is not possible to delete a domain if (1) your account is disabled, (2) another domain on your account is disabled, (3) the domain is the sandbox domain (e.g. looks something like sandbox9e987639aa.mailgun.org), or (4) your user's role permissions on the account are neither "Admin" nor "Developer".

     

    Method 2

    1. First, log in to the Mailgun Control Panel (if you have not already done so).
    2. Then, within the left-hand navigation pane, click the Sending option to expand its list of suboptions.
    3. Next, click the Domain settings suboption.
      MG.SideNavigation.png
    4. Ensure that the domain you wish to delete is displayed within the Domain drop-down list towards the upper-right portion of the page.
      DomainSelector.png
    5. Near the bottom of the page, locate the Advanced section and the Delete domain setting.
      • Note: if the domain is a sandbox domain (i.e. one that looks like this sandbox9e987639aa.mailgun.org), these system-generated testing domains cannot be deleted from your account. 
      • Note: if your user's permissions are not "Admin" or "Developer", you cannot delete the domain from your account.
        SendingOptionDomainSettingsSuboptionAdvancedSection.png
    6. Click the Delete button, and confirm your intention to delete the domain by clicking the Delete button in the pop-up modal. 
      SendingOptionDomainSettingsSuboptionAdvancedSectionDeleteModal.png

    SPECIAL NOTE: It is not possible to delete a domain if (1) your account is disabled, (2) another domain on your account is disabled, (3) the domain is the sandbox domain (e.g. looks something like sandbox9e987639aa.mailgun.org), or (4) your user's role permissions on the account are neither "Admin" nor "Developer".

     

    Method 3

    If you would like to delete a domain using the Domains API, you can find more information in our documentation.

    Need Support?

    Our Support Team here at Sinch Mailgun is happy to help! Reach out to us in the Support section of your Mailgun Control Panel, and we'll be with you shortly!