Last Updated on June 26, 2018 by Neil Murray

Though the Contact Form 7 (CF7) plugin successfully sends millions of emails every day, there are a host of issues that can delay or stop emails on both the sending and receiving ends of a typical email.

This article was set up to help people, who are having trouble sending and receiving emails from CF7, solve their problems.

Contact Form 7 successfully sends millions of emails every day

Emails from CF7 work flawlessly, without any effort, for most people

We ourselves have never had a problem sending or receiving emails from Contact Form 7. Its always worked flawlessly, on a large number of websites, on a few different servers, with no need for any changes to the default setups. It just works and always has.

We believe most users of CF7 have the same experience. CF7 having over 11 million downloads (currently around 10,000 per day), indicates that a lot of people are successfully sending emails from CF7.

BUT … it doesn’t work that easily for everyone

But not for everyone – emails don’t work easily for some CF7 users

If you spend some time in the CF7 support forum at http://wordpress.org/support/plugin/contact-form-7 you will see a lot of posts from people who do have problems with sending our receiving emails from Contact Form 7.

Contact form is not working …
… form not sending
Refuses to send email … etc.

The important point to note is that the sending and receiving of emails depends heavily on both the server where your WordPress installation is hosted and the email configuration of the local computer where the emails are supposed to be received.

If you are having CF7 email problems, you will need to investigate this issue in detail for your particular local configurations. You have our sympathy, this can be a difficult and time consuming task and you may not, in the end, get it to work.

BUT … it ain’t the plugin that is causing your problems. The plugin works!

Please try to keep that in mind as you work through some of the possible causes and solutions given below.

Note: This page is still a Work in Progress. We add more information as we become aware of other issues and solutions via the CF7 support forum at http://wordpress.org/support/plugin/contact-form-7.

If you have something you think might help others on this issue, you can use the CF7 form at the bottom of this page to contact us.

Please note however that anything that looks like a request for support or help will be ignored and deleted faster than you can imagine.

Sending

Contact Form 7 uses the standard recommended methods used to send emails in WordPress.

Current bug in WordPress 3.6 – Qmail based Hosts only

There is actually a bug in the 3.6 release that causes Contact-7 forms to fail to be emailed – but it only affects those hosts using Qmail based email systems.

It appears that WordPress used a few month old version of class-phpmailer.php, one where a bug had been introduced for Qmail based email systems. The authors of phpmailer.php had already issued an update for the file, but WordPress issued the 3.6 upgrade with the older class-phpmailer.php version 3.5.4 (version 3.5.5 had already been fixed).

In any event the WordPress core developers are now aware of the issue and have already indicated that a more current version of class-phpmailer.php (one that is fixed for Qmail) will be included when WordPress 3.7 is released.

Meanwhile to correct the issue with the Qmail bug:

1. Go to this link- https://github.com/PHPMailer/PHPMailer/blob/master/class.phpmailer.php
2. Copy the actual file contents starting with:
3. Then replace the contents of your wp-includes/class-phpmailer.php with the code from the above file – that should correct the issue if related to the Qmail bug.

NOTICE!!! the name of the file is class(dash)phpmailer.php, not (dot) as it appears in the second line comment of the source.

Source – http://wordpress.org/support/topic/wp-36-doesnt-work-with-cf7. Thanks to Jack Armstrong for this information.

If you are experiencing problems sending emails, you might consider contacting your hosting provider to ask if they use the a Qmail based email system.

The following list contains items that we have found commonly lead to email sending problems with the CF7 plugin (and WordPress in general). We suggest that people work through this list from top to bottom to try to solve their particular email sending issue.

• You need a functioning mail server
• Test if your WordPress installation is able to send emails
• Confirm wp_mail is working
• Hosting Issues
• Alternatively – try to configure email using SMTP
• Ensure proper return address is used
• Your email may be treated as spam
• Plugin or Theme Conflict
• Javascript Conflict
• Use Firebug or Chrome Dev Tools
• Contact Form 7 didn’t install or update correctly

If you are unable to send emails from the CF7 plugin, it is likely that you are unable to send emails from WordPress in general.

You need a functioning mail server

If you are trying to send emails from any WordPress installation, you will need to make sure you have a functioning mail server setup there.

Note: Local installs (using MAMP, WAMP, XAMPP etc.) often don’t have this capability. Trying to test CF7 email functionality on a local WordPress installation with no mail server capability appears to be a common mistake.

Test if your WordPress installation is able to send emails

Try going through the “forgot password” function on wp-login.php.

Do you get the email? If you don’t you will need to rectify this.

The WordPress Codex gives some guidance on this at http://codex.wordpress.org/FAQ_Troubleshooting#E-mailed_passwords_are_not_being_received

Confirm wp_mail is working

Contact Form 7 uses wp_mail to send emails. Most quality WordPress hosting will generally support this without the need for any special configuration.

wp_mail is based on the standard PHP mail() function, which uses sendmail. No account information is needed.

If you are a comfortable working with PHP, you can check if wp_mail is functioning by following this article – http://butlerblog.com/2012/09/23/testing-the-wp_mail-function/.

Note: For wp_mail to work, the settings SMTP and smtp_port (default: 25) need to be set in your php.ini file.

Hosting Issues

Some hosting providers require special settings to be applied to your WordPress installation in order to send emails from WordPress. You may need to contact your hosting provider and work with them to ensure emails are being sent correctly from your WordPress installation.

Some hosts don’t support PHP’s mail function. They often claim it’s to reduce spam since the PHP mail() function can be used to send email defining the from address as whatever you want without having to authenticate.

You should be able to get confirmation from your hosting provider that php mail() is functioning correctly from your hosting account.

Alternatively – Try to configure email using SMTP

If your hosting provider does not support wp_mail and the standard PHP mail() function, you can try to configure email sending from WordPress using SMTP (another type of mail service).

WordPress supports SMTP mail but this needs to be configured separately via the admin area of WordPress.

The following plugins can be used to setup SMTP on your WordPress site:
http://wordpress.org/plugins/configure-smtp/
http://wordpress.org/extend/plugins/wp-mail-smtp/

WP Mail SMTP reconfigures the wp_mail() function to use SMTP instead of mail() and creates an options page that allows you to specify various options. You may need to contact your hosting provider to get detailed information on the option settings required.

Note: When using SMTP you need to authenticate, so there has to be a real email address that the emails are coming from.

Most users on quality WordPress hosting will not need to use SMTP. You should avoid using SMTP if possible as using SMTP can contribute to the following email authentication issues.

Ensure Proper Return Address is Used

By default, the WordPress mailer fills in the From: field with wordpress@yourdomain.com and the From: name as WordPress. This is fine if this is a valid e-mail address.

For example, if your real e-mail is wordpress@yourdomain.com, your host should pass the email on for delivery. It will probably send your mail as long as yourdomain.com is setup to send and receive mail, even if wordpress is not a valid mail box.

But if you set you real email as the From: address and it’s something like wpgod@gmail.com, the mail may not send because gmail.com is not a domain handled by the mail server.

Quote from the CF7 Support Forum – I was having the very same problem, but only recently. Turns out that the new Dreamhost spam policy was the problem. Since it’s technically “spoofing” the user’s address to send email, Dreamhost no longer allows it.

http://wiki.dreamhost.com/Sender_Domain_Policy_and_Spoofing

Your email may be treated as spam

Your email message may have been routed to a spam folder or even worse, simply discarded as malicious. There are a couple measures you can use to convince recipient’s mail servers that your message is legitimate and should be delivered as addressed.

The following paragraphs are copied from WordPress Codex – http://codex.wordpress.org/FAQ_Troubleshooting#E-mailed_passwords_are_not_being_received

SPF: (Sender Policy Framework) This is the most common anti-spam measure used. If you are on a hosted system, there is a good chance your host has set this up for the mail server you are using. Have WordPress email you and check the message headers for evidence that the message passed the SPF check. You can get a message sent by following the Forgot Password link on the login page. To keep your old password, do not follow the link in the message. If your system email failed the SPF check, you can set up the credentials if you have access to your DNS records and your mail server’s domain belongs to you. Check the return path of the email your system sent. If the mail server listed there has your domain name, you can set up SPF credentials. There are several how-tos on the Internet.

DKIM: (Domain Key Identified Mail) This system is also used. You can use both SPF and DKIM in the same message. Again, just as with SPF, you can check if your receiving mailserver verified your host’s domain key by examining the mail header. There is a fair chance no signature key was provided, indicating your host chose to not use this protocol. Also as with SPF, if you can edit your DNS records and the mail server belongs to your domain, you can set up DKIM credentials yourself. Some how-tos exist if you search the Internet.

To get WordPress to send the proper DKIM keys, hook the ‘phpmailer_init’ action. You are passed the $phpmailer object. Set the necessary properties and return the object. See the class source code for more information. It’s on wp-includes/class-phpmailer.php .

Plugin or Theme Conflict

Plugin and theme conflicts are unfortunately a fact of life with WordPress. As one of the most popular plugins in the WordPress Repository, it’s reasonable to assume that CF7 is written so that it does not cause conflicts with other plugins and themes.

However there are many plugins and themes that are not so well written. Like many other popular plugins, CF7 is frequently reported as not working in the WordPress Forums (particularly by users with limited WordPress skill and experience) when the real cause is conflict from another theme or plugin – see http://wiki.simple-press.com/installation/troubleshooting/theme-conflicts/.

Step by step approach to finding Plugin & Theme Conflicts

1.) Disable all plugins other than CF7
a.) Does it work now? – Turn back on plugins one by one until you find the conflict
b.) You may need to clear the browser cache between each one
2.) Disable your current theme and load one of the WordPress Default themes
a.) Does it work now? – The problem is with your current selected theme
3.) With everything disabled, try (if you can) to correct the problem by reinstalling elements that may have become corrupted.

You may need to :
1.) Deactivate Contact Form 7 and completely delete it. Then re-install it into your WordPress instance.
2.) Reinstall your theme.
3.) Delete and reinstall the plugin causing the conflict.
4.) Re-upload your wp-content folder with a fresh copy.

Note: Any plugin that uses wp_mail and does not reset wp_mail_content_type back to ‘text/plain’ after sending a message can lead to unexpected problems with e-mails from WordPress.

Javascript Conflict

Contact Form 7 is a good WordPress community member in regards to it’s use of Javascript. It only loads it’s JavaScript where it is needed and only loads scripts required for the current page. It also plugs correctly into the WordPress architecture.

However there are many plugins and themes that are not so well written and a host of CF7 email problems can be due to a Javascript conflict with either your current WordPress theme or one of the other plugins you are using.

A spinning arrow continuing to spin after submitting a CF7 form, is a common symptom of a Javascript conflict.

Switch to a WordPress default theme and see if the problem goes away. If it does, you’ve most likely got a Javascript conflict with your current WordPress theme.

If switching to default theme doesn’t help it could be one of the plugins you are using that is causing the problem.

Use Firebug or Chrome Dev Tools

Use Firebug or Chrome Dev Tools to try to find the conflict. See http://wiki.simple-press.com/installation/troubleshooting/plugin-conflicts/ for some general guidance.

You will need to be skilled at using Firebug or Chrome Dev Tools to find what is causing your Javascript conflict and how to resolve it. If that description does not fit you, you can learn about these extremely useful developer tools at the following links.

https://getfirebug.com/wiki/
http://www.evotech.net/blog/2007/06/introduction-to-firebug/
http://www.youtube.com/watch?v=sHbYpl1XFiM
http://www.tipsandtricks-hq.com/debugging-javascript-code-with-firebug-1899
https://developers.google.com/chrome-developer-tools/

Remember that a problem in one script can cause issues in another. For example, some jQuery errors can stop jQuery processing any more script, which can make the culprit hard to find. A jQuery error in one of your plugins or your themes javascript files can stop jQuery processing before it gets to the CF7 script.

Contact the developer of the plugin or theme developer causing the conflict

If you identify a conflict with a particular plugin or theme, you could write to the plugin or theme developer and suggest they might have a possible conflict with CF7.

CF7 is one of the most popular plugins in the WordPress Repository, so it makes sense for developers to deal with any potential conflicts.

Also if a plugin or theme conflicts with CF7, it probably also conflicts with many other plugins. It’s generally a sign of a poorly coded theme or plugin and one that people should avoid using.

Contact Form 7 didn’t install or update correctly on your site

It is always possible that Contact Form 7 didn’t install or update correctly on your site. It’s a general problem with WordPress due to the unreliability of internet connections. Delete the plugin folder at wp-content/plugins/contact-form-7/ and install the plugin again.

Useful Links

http://codex.wordpress.org/FAQ_Troubleshooting#E-mailed_passwords_are_not_being_received
http://joshbetz.com/2010/01/problems-getting-wordpress-emails
http://www.premiumpress.com/tutorial/wordpress-email-settings/
http://www.kriesi.at/support/topic/error-sending-mail-via-the-wordpress-twicet-theme-contact-page
http://butlerblog.com/2012/09/23/testing-the-wp_mail-function/
http://www.callum-macdonald.com/code/wp-mail-smtp/
WordPress, Contact Forms, the new Anti Spam Policy and why it sucks
Fix Contact Form 7 not working with Dreamhost
http://wiki.dreamhost.com/Sender_Domain_Policy_and_Spoofing
http://wiki.simple-press.com/installation/troubleshooting/plugin-conflicts/
http://wiki.simple-press.com/installation/troubleshooting/theme-conflicts/

Receiving

There are a host of issues that can delay or stop emails on the receiving end of a typical email. You will need to investigate this issue in detail for your particular local configuration.

Quote from the CF7 Support Forum – If anyone has ‘problems’ in not receiving emails, it’s most certainly not this plugin, they should check their settings and their junk folders.

Emails are delivered late

Most emails are delivered within a few minutes, but emails can sometimes be delayed while in transit due to problems on the sender’s mail server, heavy Internet traffic, or routing problems. On rare occasions, delays can last for several hours or more.

The sender’s address is blocked

The Blocked Addresses feature in some Mail systems allows you to create a list of addresses that you don’t want to receive mail from. Mail coming in from one of these senders will neither arrive nor bounce, but will simply be discarded. Check your blocked addresses list and make sure that email address you’re using is not blocked.

You’ve enabled mail forwarding

Is the email address you’re using set to be forwarded to another email address.

Have you set up filters?

You might have set up filters which caused the email to be sent to the Trash folder or to another folder within your Mail account.

Useful Links

Troubleshooting common issues with email
Email Server Test

Do you have something you think might help others on this issue

This page is still a Work in Progress. We add more information as we become aware of other issues and solutions via the CF7 support forum at http://wordpress.org/support/plugin/contact-form-7.

If you have something you think might help others on this issue, you can use the CF7 form below to contact us.

Error: Contact form not found.

Please note that anything that looks like a request for support or help will be ignored and deleted faster than you can imagine.