Skip to content
An AWS SES wp_mail() drop-in
PHP
Branch: master
Clone or download
Latest commit d2ff7a7 Sep 13, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
inc Remove AWS SDK bundled Sep 12, 2019
.gitignore Add basic gitignore Sep 21, 2017
README.md Recommend the AWS Console for Route53 setup May 19, 2017
aws-ses-wp-mail.php Version bump Mar 27, 2018
composer.json Add min php version for namespaces Sep 21, 2017

README.md

AWS SES wp_mail() drop-in
Use AWS SES to send your WordPress emails. Easily.
A Human Made project. Maintained by @joehoyle.

AWS SES is a very simple UI-less plugin for sending wp_mail()s email via AWS SES.

Getting Set Up

Once you have git cloned the repo, or added it as a Git Submodule, add the following constants to your wp-config.php:

define( 'AWS_SES_WP_MAIL_REGION', 'us-east-1' );
define( 'AWS_SES_WP_MAIL_KEY', '' );
define( 'AWS_SES_WP_MAIL_SECRET', '' );

If you plan to use IAM instance profiles to protect your AWS credentials on disk you'll need the following configuration instead:

define('AWS_SES_WP_MAIL_REGION', 'us-east-1');
define('AWS_SES_WP_MAIL_USE_INSTANCE_PROFILE', true);

The next thing that you should do is to verify your sending domain for SES. You can do this via the AWS Console, which will allow you to automatically set headers if your DNS is hosted on Route 53. Alternatively, you can get the required DNS records by running:

wp aws-ses verify-sending-domain

Once you have verified your sending domain, you are all good to go!

Note: If you have not used SES in production previously, you need to apply to move out of the Amazon SES sandbox.

Other Commands

wp aws-ses send <to> <subject> <message> [--from-email=<email>]

Send a test email via the command line. Good for testing!

Credits

Created by Human Made for high volume and large-scale sites. We run AWS SES wp_mail() on sites with millions of monthly page views, and thousands of sites.

Written and maintained by Joe Hoyle. Thanks to all our contributors.

Interested in joining in on the fun? Join us, and become human!

You can’t perform that action at this time.