Title: Configure SMTP
Author: Scott Reilly
Published: <strong>June 15, 2009</strong>
Last modified: July 22, 2024

---

Search plugins

![](https://ps.w.org/configure-smtp/assets/banner-772x250.png?rev=3123453)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/configure-smtp/assets/icon-256x256.png?rev=3123453)

# Configure SMTP

 By [Scott Reilly](https://profiles.wordpress.org/coffee2code/)

[Download](https://downloads.wordpress.org/plugin/configure-smtp.3.5.zip)

 * [Details](https://en-ca.wordpress.org/plugins/configure-smtp/#description)
 * [Reviews](https://en-ca.wordpress.org/plugins/configure-smtp/#reviews)
 *  [Installation](https://en-ca.wordpress.org/plugins/configure-smtp/#installation)
 * [Development](https://en-ca.wordpress.org/plugins/configure-smtp/#developers)

 [Support](https://wordpress.org/support/plugin/configure-smtp/)

## Description

Configure SMTP mailing in WordPress, including support for sending email via SSL/
TLS (such as Gmail).

This plugin is the official successor to the original SMTP plugin for WordPress (
wpPHPMailer).

Use this plugin to customize the SMTP mailing system used by default by WordPress
to handle _outgoing_ emails. It offers you the ability to specify:

 * SMTP host name
 * SMTP port number
 * If SMTPAuth (authentication) should be used
 * SMTP username
 * SMTP password
 * If the SMTP connection needs to occur over ssl or tls

In addition, you can instead indicate that you wish to use Gmail to handle outgoing
email, in which case the above settings are automatically configured to values appropriate
for Gmail, though you’ll need to specify your Gmail email address (including the“
@gmail.com”) and password.

Regardless of whether SMTP is enabled, the plugin provides you the ability to define
the name and email of the ‘From:’ field for all outgoing emails.

A simple test button is also available that allows you to send a test email to yourself
to check if sending email has been properly configured for your site.

Links: [Plugin Homepage](https://coffee2code.com/wp-plugins/configure-smtp/) | [Plugin Directory Page](https://wordpress.org/plugins/configure-smtp/)
| [GitHub](https://github.com/coffee2code/configure-smtp/) | [Author Homepage](https://coffee2code.com)

## Screenshots

 * [[
 * A screenshot of the plugin’s admin settings page.

## Installation

 1. Whether installing or updating, whether this plugin or any other, it is always 
    advisable to back-up your data before starting.
 2. Install via the built-in WordPress plugin installer. Or install the plugin code
    inside the plugins directory for your site (typically `/wp-content/plugins/`).
 3. Activate the plugin through the ‘Plugins’ admin menu in WordPress
 4. Go to “Settings” -> “Configure SMTP” and configure the plugin’s settings. (You 
    can also use the “Settings” link in the plugin’s entry on the admin “Plugins” page).
 5. (Optional.) Use the built-in test tool (also located on the plugin’s settings page)
    to see if your blog can properly send out emails.

## FAQ

### I am already able to receive email sent by my site, so would I have any use or need for this plugin?

Most likely, no. Not unless you have a preference for having your mail sent out 
via a different SMTP server, such as Gmail.

### How do I find out my SMTP host, and/or if I need to use SMTPAuth and what my username and password for that are?

Check out the settings for your local email program. More than likely that is configured
to use an outgoing SMTP server. Otherwise, read through documentation provided by
your host or contact them (or someone more intimately knowledgeable about your situation)
directly.

### I’ve sent out a few test emails using the test button after having tried different values for some of the settings; how do I know which one worked?

If your settings worked, you should receive the test email at the email address 
associated with your WordPress site user account. That email contains a timestamp
which was reported to you by the plugin when the email was sent. If you are trying
out various setting values, be sure to record what your settings were and what the
timestamp was when sending with those settings.

### Why am I getting this error when attempting to send a test message: `SMTP Error: Could not connect to SMTP host.`?

There are a number of reasons you could be getting this error:

 * Your server (or a router to which it is connected) may be blocking all outgoing
   SMTP traffic.
 * Your mail server may be configured to allow SMTP connections only from certain
   servers.
 * You have supplied incorrect server settings (hostname, port number, secure protocol
   type).

### What am I getting this error: `SMTP Error: Could not authenticate.`?

The connection to the SMTP server was successful, but the credentials you provided(
username and/or password) are not correct. Bear in mind these credentials are likely
unrelated to the ones you use to log into your site.

### Does this plugin include unit tests?

Yes.

## Reviews

![](https://secure.gravatar.com/avatar/6660919817521daaa0aa52aa2692654e5a4eb763de6f8f91be61e7f58cd1404f?
s=60&d=retro&r=g)

### 󠀁[First thing I install on all my WP websites](https://wordpress.org/support/topic/first-thing-i-install-on-all-my-wp-websites/)󠁿

 [steadiflite](https://profiles.wordpress.org/steadiflite/) March 12, 2020

Configure SMTP is a staple of setting up a useful WordPress website, I would call
it “a household name” for WP installations (if there’s any such thing as household
names in this area). Anyway, what a helpful, simple and great Plugin. Thank you,
great work, @Scott_Riley!

![](https://secure.gravatar.com/avatar/46d2b5559bf9a101821be7470f2e1820b6c908ea7a5f540444c0d7a588a2a29c?
s=60&d=retro&r=g)

### 󠀁[Simple and functional way to configure SMTP settings in your WordPress](https://wordpress.org/support/topic/simple-and-functional-way-to-configure-smtp-settings-in-your-wordpress/)󠁿

 [Javier Carazo](https://profiles.wordpress.org/carazo/) March 19, 2019

Most of my users and customers ask me: why my mails are not being sent? Why some
mails sent from my site do not arrives? The problem are spam filters and things 
like this, so SMTP is a basic tool to operate a site or ecommerce. I have used many
plugin to do this task but none like this. This solves the problem in an easy and
functional way.

![](https://secure.gravatar.com/avatar/25c588d4254d237665f81571ea1aeab3182e28b033d963b39aced99c0252f03b?
s=60&d=retro&r=g)

### 󠀁[Still works!](https://wordpress.org/support/topic/still-works-125/)󠁿

 [pdwalker](https://profiles.wordpress.org/pdwalker/) January 4, 2018

There are some minor warnings under php7. See here for the fix: https://wordpress.
org/support/topic/warning-declaration-of-c2c_configuresmtp-with-plugin-installed/#
post-9832908 Hopefully the author will be back to fix the warnings correctly.

![](https://secure.gravatar.com/avatar/712579fd229550b35fb656e009770d9b9edc2bd4299c79916d182214b37b155a?
s=60&d=retro&r=g)

### 󠀁[The Best](https://wordpress.org/support/topic/the-best-1069/)󠁿

 [battarov](https://profiles.wordpress.org/battarov/) November 1, 2017

this is the only SMTP plugin that is working woth contact form 7 . so don’t wast
your time with other alternative plugins , this one is the best and still working
like a charm.

![](https://secure.gravatar.com/avatar/c288f7130001d67bca47ff7a64d1dc000db0682d9b7bb4102207737be1fe1465?
s=60&d=retro&r=g)

### 󠀁[Fast and Simple](https://wordpress.org/support/topic/fast-and-simple-26/)󠁿

 [sraymond44](https://profiles.wordpress.org/sraymond44/) August 22, 2017

Simple to install and configure. Had it working within minutes!

![](https://secure.gravatar.com/avatar/3446ca5832ddba200ae5761e43541f7cbc8ea74203085b598a18736f3490077d?
s=60&d=retro&r=g)

### 󠀁[simple and sweet](https://wordpress.org/support/topic/simple-and-sweet-14/)󠁿

 [Espi](https://profiles.wordpress.org/josheprovoedu/) March 14, 2017

does exactly what it says. Been working like a charm

 [ Read all 45 reviews ](https://wordpress.org/support/plugin/configure-smtp/reviews/)

## Contributors & Developers

“Configure SMTP” is open source software. The following people have contributed 
to this plugin.

Contributors

 *   [ Scott Reilly ](https://profiles.wordpress.org/coffee2code/)

“Configure SMTP” has been translated into 2 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/configure-smtp/contributors)
for their contributions.

[Translate “Configure SMTP” into your language.](https://translate.wordpress.org/projects/wp-plugins/configure-smtp)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/configure-smtp/), check
out the [SVN repository](https://plugins.svn.wordpress.org/configure-smtp/), or 
subscribe to the [development log](https://plugins.trac.wordpress.org/log/configure-smtp/)
by [RSS](https://plugins.trac.wordpress.org/log/configure-smtp/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 3.2 (2016-11-14)

 * New: Add unit tests.
 * Change: Handle ‘Send email via Gmail?’ checkbox changes with JS event listener
   rather than explicit ‘onclick’.
 * Change: Move JS into file and enqueue rather outputting directly into footer.
 * Change: Update plugin framework to 045. (Too many changes to list.)
 * Change: Improve singleton implementation.
    - Add `get_instance()` static method for returning/creating singleton instance.
    - Make static variable ‘instance’ private.
    - Make constructor protected.
    - Make class final.
    - Additional related changes in plugin framework (protected constructor, erroring`
      __clone()` and `__wakeup()`).
 * Change: Cast submitted ‘smtp_auth’ (bool), ‘port’ (int), and ‘wordwrap’ (int)
   values to proper type before use.
 * Change: Verify submitted ‘smtp_secure’ value is one of the viable options.
 * New: Add class constant `SETTING_NAME` (to store setting name) and use it in `
   uninstall()`.
 * Change: Remove pre-WP3.2-only JavaScript code.
 * Change: Use explicit path when requiring plugin framework.
 * Fix: Explicitly declare `activation()` and `uninstall()` static.
 * Fix: For `options_page_description()`, match method signature of parent class.
 * Change: Add support for language packs:
    - Set textdomain using a string instead of a variable.
    - Remove .pot file and /lang subdirectory.
 * Change: Discontinue use of PHP4-style constructor.
 * Change: Prevent execution of code if file is directly accessed.
 * Change: Minor code reformatting (spacing, bracing, conditional comparison order).
 * Change: Minor documentation reformatting (spacing, punctuation).
 * Change: Re-license as GPLv2 or later (from X11).
 * New: Add ‘License’ and ‘License URI’ header tags to readme.txt and plugin file.
 * New: Add LICENSE file.
 * New: Add empty index.php to prevent files from being listed if web server has
   enabled directory listings.
 * Change: Use ’email’ instead of ‘e-mail’ on-screen and in documentation.
 * Change: Use ‘Gmail’ instead of ‘GMail’ on-screen and in documentation.
 * Change: Remove file-ending PHP close tag.
 * Change: Reformat plugin header.
 * Change: Note compatibility through WP 4.7+.
 * Change: Dropped compatibility with version of WP older than 4.2.
 * Change: Update donate link.
 * Change: Update copyright date (2017).

#### 3.1

 * Add new debugging configuration option
 * Fix bug that resulted from WP 3.2’s update to a new phpmailer
 * Fix bug with checking ‘Use GMail?’ did not auto-reset settings accordingly (jQuery
   bug regarding .attr() vs .prop() introduced in jQ 1.6 in WP 3.2)
 * Fix to call add_filter() instead of add_action() for ‘wp_mail_from’ (props Callum
   Macdonald)
 * Fix to call add_filter() instead of add_action() for ‘wp_mail_from_name’
 * Store error messages for later display rather than immediately outputting (too
   early)
 * Save a static version of itself in class variable $instance
 * Deprecate use of global variable $c2c_configure_smtp to store instance
 * Add explicit empty() checks in a couple places
 * Delete plugin settings on uninstallation
 * Add __construct(), activation(), and uninstall()
 * Add more FAQ questions
 * Regenerate .pot
 * Update plugin framework to version 023
 * Note compatibility through WP 3.2+
 * Drop compatibility with versions of WP older than 3.0
 * Explicitly declare all functions as public and class variables as private
 * Minor code formatting changes (spacing)
 * Update copyright date (2011)
 * Add plugin homepage and author links in description in readme.txt

_Full changelog is available in [CHANGELOG.md](https://github.com/coffee2code/blog-time/blob/master/CHANGELOG.md)._

## Meta

 *  Version **3.5**
 *  Last updated: **2 years ago**
 *  Active installations: **7,000+**
 *  WordPress Version: ** 5.5 or higher **
 *  Tested up to: **6.5.8**
 *  Language:
 * [Dutch](https://nl.wordpress.org/plugins/configure-smtp/), [English (UK)](https://en-gb.wordpress.org/plugins/configure-smtp/),
   and [English (US)](https://wordpress.org/plugins/configure-smtp/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/configure-smtp)
 * Tags:
 * [coffee2code](https://en-ca.wordpress.org/plugins/tags/coffee2code/)[email](https://en-ca.wordpress.org/plugins/tags/email/)
   [gmail](https://en-ca.wordpress.org/plugins/tags/gmail/)[phpmailer](https://en-ca.wordpress.org/plugins/tags/phpmailer/)
   [smtp](https://en-ca.wordpress.org/plugins/tags/smtp/)
 *  [Advanced View](https://en-ca.wordpress.org/plugins/configure-smtp/advanced/)

## Ratings

 4.9 out of 5 stars.

 *  [  44 5-star reviews     ](https://wordpress.org/support/plugin/configure-smtp/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/configure-smtp/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/configure-smtp/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/configure-smtp/reviews/?filter=2)
 *  [  1 1-star review     ](https://wordpress.org/support/plugin/configure-smtp/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/configure-smtp/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/configure-smtp/reviews/)

## Contributors

 *   [ Scott Reilly ](https://profiles.wordpress.org/coffee2code/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/configure-smtp/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=6ARCFJ9TX3522)