PHPackages                             roots/acorn-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 &amp; Notifications](/categories/mail)
4. /
5. roots/acorn-mail

ActivePackage[Mail &amp; Notifications](/categories/mail)

roots/acorn-mail
================

Simple WordPress SMTP using Acorn's mail configuration.

v2.0.0(2mo ago)3236.8k↓11.1%3[1 issues](https://github.com/roots/acorn-mail/issues)[2 PRs](https://github.com/roots/acorn-mail/pulls)MITPHPPHP &gt;=8.3CI passing

Since Mar 6Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/roots/acorn-mail)[ Packagist](https://packagist.org/packages/roots/acorn-mail)[ GitHub Sponsors](https://github.com/roots)[ RSS](/packages/roots-acorn-mail/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (6)Dependencies (4)Versions (8)Used By (0)

Acorn Mail
==========

[](#acorn-mail)

[![Latest Stable Version](https://camo.githubusercontent.com/1eed9a36e25e6a40b236c47c313ef26951e09638ff16165c0b55f013072cc6e7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726f6f74732f61636f726e2d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/1eed9a36e25e6a40b236c47c313ef26951e09638ff16165c0b55f013072cc6e7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726f6f74732f61636f726e2d6d61696c2e7376673f7374796c653d666c61742d737175617265)[![Packagist Downloads](https://camo.githubusercontent.com/3fe391d3fb7665735219359e3af4c115f9689ae5705970164ec929e3bb4dc5b9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f726f6f74732f61636f726e2d6d61696c3f6c6162656c3d646f776e6c6f61647326636f6c6f72423d32623330373226636f6c6f72413d353235646463267374796c653d666c61742d737175617265)](https://packagist.org/packages/roots/acorn-mail)[![Build Status](https://camo.githubusercontent.com/f549871fb4f258c9f0d925fce3ff8305338be4044337622746dcec10c626d2eb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f726f6f74732f61636f726e2d6d61696c2f6d61696e2e796d6c3f6272616e63683d6d61696e267374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/f549871fb4f258c9f0d925fce3ff8305338be4044337622746dcec10c626d2eb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f726f6f74732f61636f726e2d6d61696c2f6d61696e2e796d6c3f6272616e63683d6d61696e267374796c653d666c61742d737175617265)[![Follow Roots](https://camo.githubusercontent.com/222256dbdeac58e77f017d847dca30ff4cab027cdf3abfec8e5bfd59de240547/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666f6c6c6f7725323040726f6f747377702d3164613166323f6c6f676f3d74776974746572266c6f676f436f6c6f723d666666666666266d6573736167653d267374796c653d666c61742d737175617265)](https://twitter.com/rootswp)[![Sponsor Roots](https://camo.githubusercontent.com/31e13361135ff96d01f1eb97157d052029e6f236249996072d8b6bd60b40e9cd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73706f6e736f72253230726f6f74732d3532356464633f6c6f676f3d676974687562267374796c653d666c61742d737175617265266c6f676f436f6c6f723d666666666666266d6573736167653d)](https://github.com/sponsors/roots)

Acorn Mail is a simple package handling WordPress SMTP using Acorn's mail configuration.

Support us
----------

[](#support-us)

Roots is an independent open source org, supported only by developers like you. Your sponsorship funds [WP Packages](https://wp-packages.org/) and the entire Roots ecosystem, and keeps them independent. Support us by purchasing [Radicle](https://roots.io/radicle/) or [sponsoring us on GitHub](https://github.com/sponsors/roots) — sponsors get access to our private Discord.

Requirements
------------

[](#requirements)

- [PHP](https://secure.php.net/manual/en/install.php) &gt;= 8.3
- [Acorn](https://github.com/roots/acorn) &gt;= 6.0

Installation
------------

[](#installation)

Install via Composer:

```
$ composer require roots/acorn-mail
```

Getting Started
---------------

[](#getting-started)

Start by optionally publishing Acorn's mail config:

```
$ wp acorn mail:config
```

SMTP credentials can be found in the published `mail.php` config file and default to environment variables.

Usage
-----

[](#usage)

For most configurations, you can simply set the following variables in your environment:

```
MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_FROM_ADDRESS=
MAIL_FROM_NAME=
```

If you need to change the default scheme from `tls`, you can set the scheme variable:

```
MAIL_SCHEME=ssl
```

Once the credentials are properly configured, you can send a test email using Acorn's CLI:

```
$ wp acorn mail:test [--to=] [--subject=] [--body=]
```

You can customize the test email subject and body:

```
# Test with custom subject and body
$ wp acorn mail:test --subject="Deploy Test" --body="Deployment successful"

# Test with custom recipient
$ wp acorn mail:test --to=admin@example.com
```

If any errors are detected, they will be printed to console.

Community
---------

[](#community)

Keep track of development and community news.

- Join us on Discord by [sponsoring us on GitHub](https://github.com/sponsors/roots)
- Join us on [Roots Discourse](https://discourse.roots.io/)
- Follow [@rootswp on Twitter](https://twitter.com/rootswp)
- Follow the [Roots Blog](https://roots.io/blog/)
- Subscribe to the [Roots Newsletter](https://roots.io/subscribe/)

###  Health Score

54

—

FairBetter than 96% of packages

Maintenance83

Actively maintained with recent releases

Popularity41

Moderate usage in the ecosystem

Community17

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 75% of commits — single point of failure

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 ~153 days

Recently: every ~186 days

Total

6

Last Release

84d ago

Major Versions

v1.0.4 → v2.0.02026-04-11

PHP version history (2 changes)v1.0.0PHP &gt;=8.1

v2.0.0PHP &gt;=8.3

### Community

Maintainers

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

![](https://avatars.githubusercontent.com/u/5745907?v=4)[Brandon](/maintainers/Log1x)[@Log1x](https://github.com/Log1x)

---

Top Contributors

[![Log1x](https://avatars.githubusercontent.com/u/5745907?v=4)](https://github.com/Log1x "Log1x (27 commits)")[![retlehs](https://avatars.githubusercontent.com/u/115911?v=4)](https://github.com/retlehs "retlehs (5 commits)")[![tombroucke](https://avatars.githubusercontent.com/u/24292260?v=4)](https://github.com/tombroucke "tombroucke (2 commits)")[![ribvid](https://avatars.githubusercontent.com/u/15885974?v=4)](https://github.com/ribvid "ribvid (1 commits)")[![simondotwhite](https://avatars.githubusercontent.com/u/793770?v=4)](https://github.com/simondotwhite "simondotwhite (1 commits)")

---

Tags

acornacorn-packageemaillaravellaravel-mailsmtpwordpresswordpress-laravel

###  Code Quality

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/roots-acorn-mail/health.svg)

```
[![Health](https://phpackages.com/badges/roots-acorn-mail/health.svg)](https://phpackages.com/packages/roots-acorn-mail)
```

###  Alternatives

[maize-tech/laravel-email-domain-rule

Laravel Email Domain Rule

612.0k](/packages/maize-tech-laravel-email-domain-rule)[sarfraznawaz2005/noty

Laravel package to incorporate noty flash notifications into laravel.

324.5k](/packages/sarfraznawaz2005-noty)

PHPackages © 2026

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