PHPackages                             humanmade/aws-ses-wp-mail - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. humanmade/aws-ses-wp-mail

ActiveWordpress-plugin[Mail & Notifications](/categories/mail)

humanmade/aws-ses-wp-mail
=========================

WordPress plugin to send mail via SES

1.4.0(2w ago)188268.0k↓34.2%51[5 issues](https://github.com/humanmade/aws-ses-wp-mail/issues)[3 PRs](https://github.com/humanmade/aws-ses-wp-mail/pulls)2GPL-2.0+PHPPHP >=7.2

Since Apr 5Pushed 2w ago31 watchersCompare

[ Source](https://github.com/humanmade/aws-ses-wp-mail)[ Packagist](https://packagist.org/packages/humanmade/aws-ses-wp-mail)[ Docs](https://github.com/humanmade/aws-ses-wp-mail)[ RSS](/packages/humanmade-aws-ses-wp-mail/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (7)Dependencies (4)Versions (14)Used By (2)

   **AWS SES wp\_mail() drop-in**
 Use AWS SES to send your WordPress emails. Easily.     A **[Human Made](https://hmn.md/)** project. Maintained by @joehoyle.   [![](https://camo.githubusercontent.com/21ddd8db8af0243ccabd437a33ded6e2da1e9777d1b4d75f30ab9ac80803c90a/68747470733a2f2f686d6e2e6d642f636f6e74656e742f7468656d65732f686d6e6d642f6173736574732f696d616765732f686d2d6c6f676f2e737667)](https://camo.githubusercontent.com/21ddd8db8af0243ccabd437a33ded6e2da1e9777d1b4d75f30ab9ac80803c90a/68747470733a2f2f686d6e2e6d642f636f6e74656e742f7468656d65732f686d6e6d642f6173736574732f696d616765732f686d2d6c6f676f2e737667)  AWS SES is a very simple UI-less plugin for sending `wp_mail()`s email via AWS SES.

Getting Set Up
==============

[](#getting-set-up)

Once you have `git clone`d 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', '' );
define( 'AWS_SES_WP_MAIL_CONFIG_SET', '' );
```

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](http://docs.aws.amazon.com/ses/latest/DeveloperGuide/request-production-access.html).

### Configuration Sets

[](#configuration-sets)

To better track your mail activity for monitoring or statistics you can use the configuration sets. To enable it you will first need to create your Configuration Set on AWS SES Console and add the configuration set name as the value to the `AWS_SES_WP_MAIL_CONFIG_SET` constant.

Detailed information on the setup and usage you find here:

### SESv2 and Tenant Isolation

[](#sesv2-and-tenant-isolation)

This plugin automatically uses the **AWS SESv2 API** when `Aws\SesV2\SesV2Client` is available in the installed SDK (requires `aws/aws-sdk-php >= 3.133`), falling back to SESv1 for older SDK versions.

To route sends through an SESv2 tenant (for reputation isolation and per-tenant statistics), set the tenant name constant:

```
define( 'AWS_SES_WP_MAIL_TENANT_NAME', 'your-tenant-name' );
```

**IAM permissions:** When using SESv2, your IAM policy must include `sesv2:SendEmail` in addition to the existing `ses:SendEmail` action. The policy resources should include your identity ARNs, configuration set ARN, and tenant ARN.

Other Commands
==============

[](#other-commands)

`wp aws-ses send    [--from-email=]`

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

Credits
=======

[](#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](https://github.com/joehoyle). Thanks to all our [contributors](https://github.com/humanmade/S3-Uploads/graphs/contributors).

Interested in joining in on the fun? [Join us, and become human!](https://hmn.md/is/hiring/)

###  Health Score

65

—

FairBetter than 99% of packages

Maintenance96

Actively maintained with recent releases

Popularity53

Moderate usage in the ecosystem

Community38

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor3

3 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~435 days

Recently: every ~511 days

Total

7

Last Release

15d ago

Major Versions

1.2.0 → 2.0.0-alpha2021-09-14

PHP version history (2 changes)1.0.0PHP >=5.3

1.3.1PHP >=7.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/21655?v=4)[Ryan McCue](/maintainers/rmccue)[@rmccue](https://github.com/rmccue)

![](https://www.gravatar.com/avatar/77dbeefb7745010589603f2ffc6ff310d8f700b58e08d52af190744c43342526?d=identicon)[roborourke](/maintainers/roborourke)

![](https://www.gravatar.com/avatar/f1d0ffccdc5d339ff98a91e1b224a0d92f93dc8c2f772124473a76655b83129c?d=identicon)[joehoyle](/maintainers/joehoyle)

---

Top Contributors

[![joehoyle](https://avatars.githubusercontent.com/u/161683?v=4)](https://github.com/joehoyle "joehoyle (30 commits)")[![rmccue](https://avatars.githubusercontent.com/u/21655?v=4)](https://github.com/rmccue "rmccue (18 commits)")[![ferschubert-hm](https://avatars.githubusercontent.com/u/87646067?v=4)](https://github.com/ferschubert-hm "ferschubert-hm (14 commits)")[![roborourke](https://avatars.githubusercontent.com/u/23417?v=4)](https://github.com/roborourke "roborourke (9 commits)")[![mikelittle](https://avatars.githubusercontent.com/u/358499?v=4)](https://github.com/mikelittle "mikelittle (7 commits)")[![johnbillion](https://avatars.githubusercontent.com/u/208434?v=4)](https://github.com/johnbillion "johnbillion (7 commits)")[![loganyott](https://avatars.githubusercontent.com/u/4369081?v=4)](https://github.com/loganyott "loganyott (3 commits)")[![kovshenin](https://avatars.githubusercontent.com/u/108344?v=4)](https://github.com/kovshenin "kovshenin (3 commits)")[![aaronjorbin](https://avatars.githubusercontent.com/u/622599?v=4)](https://github.com/aaronjorbin "aaronjorbin (2 commits)")[![tareiking](https://avatars.githubusercontent.com/u/687789?v=4)](https://github.com/tareiking "tareiking (2 commits)")[![Japh](https://avatars.githubusercontent.com/u/237905?v=4)](https://github.com/Japh "Japh (1 commits)")[![tomjn](https://avatars.githubusercontent.com/u/58855?v=4)](https://github.com/tomjn "tomjn (1 commits)")[![tlaverdure](https://avatars.githubusercontent.com/u/1731025?v=4)](https://github.com/tlaverdure "tlaverdure (1 commits)")[![nathanielks](https://avatars.githubusercontent.com/u/314009?v=4)](https://github.com/nathanielks "nathanielks (1 commits)")

---

Tags

wordpress

### Embed Badge

![Health badge](/badges/humanmade-aws-ses-wp-mail/health.svg)

```
[![Health](https://phpackages.com/badges/humanmade-aws-ses-wp-mail/health.svg)](https://phpackages.com/packages/humanmade-aws-ses-wp-mail)
```

###  Alternatives

[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45444.2k1](/packages/pressbooks-pressbooks)[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.5k10](/packages/helsingborg-stad-municipio)[etailors/mautic-amazon-ses

Amazon SES Mailer Plugin for Mautic

574.2k](/packages/etailors-mautic-amazon-ses)[altis/core

Core module for Altis

19228.0k3](/packages/altis-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)