WPForms Blog

WordPress Tutorials, Tips, and Resources to Help Grow Your Business

How to Send WordPress Emails With Mailgun Using WP Mail SMTP

by Shahzad Saeed on Dec 12, 2017

Have you noticed that you’re not receiving WordPress contact form notifications? You might be wondering why WPForms isn’t sending you emails when someone fills out your forms, or why you aren’t seeing any WordPress notifications.

In this tutorial, we’ll walk you through how to fix email delivery issues by sending WordPress emails with Mailgun using WP Mail SMTP.

Why Email Notifications Don’t Work

Maybe you’ve noticed that WordPress isn’t sending you email notifications because form entries are piling up in your WordPress dashboard, or frustrated visitors start to reach out to you using social media or other methods.

The most common reason for missing these emails is due to your WordPress hosting server. Usually it isn’t configured to use the PHP mail() function, which WordPress uses by default to send emails generated by WordPress or any contact plugin like WPForms.

Thankfully, you can work around this issue by using SMTP.

SMTP (Simple Mail Transfer Protocol) is the industry standard for sending emails. Unlike PHP mail function, SMTP uses proper authentication which increases email deliverability. That’s why we recommend using SMTP to send emails in WordPress.

In this article we’ll show one of the SMTP services we recommend: Mailgun.

How to Fix Your Form Notifications

Mailgun is a popular email service provider that allows website owners to send large quantities of emails. You can send your first 10,000 emails for free every month (or 100 emails per hour), though beyond that it’s a paid service. But that’s more than enough for most small websites.

Let’s get started setting up your site to send WordPress emails with Mailgun using WP Mail SMTP.

1. Sign up for a Mailgun account

First you need to sign up for an account on the Mailgun website.

Sign up for a Mailgun account

As an added verification step Mailgun will require that you enter credit card information to set up an account, even if using a free account. For more information, please see Mailgun’s sign up page.

After completing the short signup form, you’ll have a couple of additional verification steps to complete. Multiple levels of verification is what allows Mailgun to better ensure email deliverability for all of their users.

First, you should receive an email to verify your Mailgun account. After clicking the verification link, you’ll then need to enter a mobile number to receive a text verification code.

Verify Mailgun account

Once you’ve completed these steps, you’ll be taken to the login page. Go ahead and log into your new Mailgun account.

After logging in, you’ll be taken to your Mailgun dashboard. If you didn’t enter credit card details earlier, you’ll be prompted for that information again here. Otherwise, you’ll see a graph that can later show some statistics about the emails you send.

When you’re ready, click on Domains in the main menu.

Go to Domains in Mailgun dashboard

On the Domains page, you’ll need to click the Add New Domain button.

Add new domain to Mailgun

Next, you’ll need to enter a subdomain of your website’s domain name.

What does that mean, exactly? A subdomain replaces the “www” part of your website’s address; for example: “subdomain.yourwebsite.com.” Subdomains can be used to add separate sections or directories to your website (like how some sites have their blogs on a subdomain such as blog.example.com).

In this case, the subdomain we’ll create will be used by Mailgun to send emails.

We’ll create the actual subdomain in the next step. For now, you can just enter a subdomain such as mail.yourwebsite.com or mg.yourwebsite.com. (It doesn’t really matter what you name it, but using “mail” or “mg” makes it more clear what its purpose is.)

Add a domain to Mailgun

As we continue into the next step, be sure to keep this tab or window open as we’ll return to this page later.

2. Verify Your Domain

As a way of both protecting site owners and their visitors, some SMTP services like Mailgun require that you verify your domain by adding records to your site’s DNS. You can find more information on the benefits of verifying your domain in Mailgun’s guide.

First, you’ll need to open your site’s DNS settings. If you’re not sure how to find these, Mailgun will provide you with some helpful links shown on their setup page when you’re adding a new domain.

Mailgun Domains page

If you’re not sure where to find your site’s DNS settings or feel unsure about making changes, please contact your site’s hosting provider.

Or for more details on modifying a site’s DNS, we recommend WPBeginner’s tutorial on DNS settings.

Once your DNS settings are open, you should see an option to add a new record. Let’s start off with the TXT records.

TXT Records

To make it possible for Mailgun to verify your domain, you’ll need to add two TXT records to your site’s DNS. Be sure to copy them carefully, as you’ll need the exact values from your Mailgun account for the verification to work.

In your site’s DNS settings you may also see a TTL field, or Time To Live, field for the record. You can leave this blank to allow the default TTL value to be used.

MX Records

The next step is to add MX, or Mail Exchanger, records.

If you are already using MX records to point to an email provider, such as G Suite, skip this step to avoid email delivery issues from a DNS conflict.

If unsure of any changes, be sure to reach out to your site’s hosting provider.

Mailgun’s MX records are the same for everyone:

First MX record:

  • Type: MX
  • Priority: 10
  • Value: “mxa.mailgun.org”

Second MX record:

  • Type: MX
  • Priority: 10
  • Value: “mxb.mailgun.org”

Once you’ve completed these steps, your DNS settings are all set.

3. Check your Mailgun Verification Status

Now Mailgun will need to verify that your domain has proper DNS records. This verification can take a while (sometimes 24-48 hours) because DNS records may take some time to update.

You can check the status of your domain verification any time by visiting the Domains page in your Mailgun account. Once Mailgun can verify the DNS changes you made, it will show active status next to your domain name.

View active domain on Mailgun

However, you can skip to the next step while you wait for this verification to complete. Just be sure to keep this tab or window open, as we’ll need it a little later.

4. Configure WordPress to Send Emails

Now that you’ve set up your DNS, you can prepare your WordPress site to start using Mailgun with WP Mail SMTP for sending emails.

The first thing you need to do is install and activate the WP Mail SMTP plugin. For more details, see our step by step guide on how to install a WordPress plugin.

After installing and activating this plugin, you need to visit Settings » WP Mail SMTP to configure plugin settings.

On the WP Mail SMTP Settings page, you’ll first need to enter the From Email and From Name. These will fill with your site’s admin email and site name by default, but we recommend setting the From Email to the same email address you used to create your Mailgun account for the most reliable delivery.

WP Mail SMTP settings

Next, in the Mailer field you’ll need to select the Mailgun option.

We also recommend checking the optional Return Path checkbox to Set the return-path to match the From Email. With this enabled, you’ll be emailed if any messages bounce as a result of issues with the recipient’s email.

WP Mail SMTP Mailer settings for Mailgun

After selecting Mailgun as your mailer, a new Mailgun section will appear. Here, you’ll need to enter API and domain information.

Even if your domain is still waiting to be verified, Mailgun will provide the information you need here. To access this, you’ll need to return to the tab or window with your Mailgun domain details.

If you look at the bottom the section named Domain Information, you should see the API Key.

Copy Mailgun API key

Once you’ve copied the key, return to the WP Mail SMTP settings and paste it into the API Key field.

Then for the Domain Name, enter the subdomain you created in Mailgun. If needed, you can find this at the top of the Mailgun page with your API key.

Domain name for Mailgun

Once this information is complete, go ahead and save your settings.

Enter Mailgun settings in WP Mail SMTP

5. Send a Test Email

Before proceeding with this step, make sure that the verification process from Step 3 is complete. This may take a while, so it’s possible you’ll need to come back to this later.

Once your domain is verified and your settings have been added to WP Mail SMTP, it’s important to send a test email to ensure that everything is working properly. To do this, make sure you’re on the Settings » WP Mail SMTP page and open the Email Test tab.

Send test email in WP Mail SMTP

On this tab, you can enter any email address that you have access to and click the Send Email button.

After sending the email, you should see a success message.

WP Mail SMTP test email was sent successfully

If you check the inbox for that email address, you should receive the email for this test.

Note: Be sure to also submit a couple of test submissions for your forms after completing this setup to check that emails deliver successfully.

If you see any issues, we recommend setting the From Email in your form’s notification settings to the same email you set up Mailgun with.

That’s it! You have successfully setup your site to send WordPress emails with Mailgun. Now your form notifications will reliably be delivered.

Looking for more email notification tips? You might also want to check out our guide on how to send users confirmation emails from WordPress forms. This is a great way to reassure visitors that their message has been received, and prevent them from sending duplicates.

Don’t have WPForms yet? What are you waiting for? Get started with the most powerful WordPress forms plugin today.

If you like this article, then please follow us on Facebook and Twitter for more free WordPress tutorials.


  1. Hi!

    I have a problem with my WP-Form, the checkboxers does’t work. The you press on a checkbox it does’t check, it stays empty.

    You can try it at [link removed]

    How can I fix it?

    1. Hi Linus,

      I see what you mean, and it looks like your theme is removing the normal checkbox styling. We can add this back, though, with a little custom CSS:

      .wpforms-container input[type=radio] {
      	-webkit-appearance: radio !important;
      .wpforms-container input[type=checkbox] {
      	-webkit-appearance: checkbox !important;
      .wpforms-container input[type=radio]:checked:before,
      .wpforms-container input[type=radio]:before,
      .wpforms-container input[type=checkbox]:checked:before,
      .wpforms-container input[type=checkbox]:before,
      .wpforms-container input[type=radio]:checked:after,
      .wpforms-container input[type=radio]:after,
      .wpforms-container input[type=checkbox]:checked:after,
      .wpforms-container input[type=checkbox]:after {
      	display: none !important;

      The above CSS should fix any issues with Multiple Choice fields as well (these issues tend to happen at the same time). And in case it helps, here’s WPBeginner’s tutorial on how to add custom CSS to your site.

      I hope that helps! If you have any other questions, please get in touch 🙂

  2. i use mailgun
    and mailgun verify my domain already

    i test send mail and this error

    what shuld i do?

    There was a problem while sending a test email.

    The related debugging output is shown below:

    WordPress: 4.9.1
    PHP: 5.6.32
    WP Mail SMTP: 1.0.2
    Mailer: mailgun
    Host: localhost
    Port: 25
    SMTPSecure: NULL
    SMTPAutoTLS: bool(true)
    SMTPAuth: bool(false)

    1. Hi Korly,

      Sorry for the trouble! The best next step is to run back through the tutorial to double check that everything’s in place. With so many parts to Mailgun’s setup, this is the most common cause of errors that we see.

      I took a look at WP Mail SMTP’s support forum, and here’s a thread with this same issue and a couple suggestions to try, as well.

      If you still see this issue after giving both of those a try, please let us know! If you have a paid license with WPForms, you can contact our support here. Otherwise, please post to WP Mail SMTP’s support forum.

      Thanks! 🙂

  3. hi…
    i have error notification if test email

    WordPress: 4.9.1
    WordPress MS: No
    PHP: 5.4.45
    WP Mail SMTP: 1.2.2

    Mailer: mailgun
    Constants: No
    Api Key / Domain: Yes

    Business Verification

    how to fix it?


Add a Comment

We're glad you have chosen to leave a comment. Please keep in mind that all comments are moderated according to our privacy policy, and all links are nofollow. Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.