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

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

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

Simple WordPress SMTP using Acorn's mail configuration.

v1.0.4(3mo ago)2820.3k↓12.8%4[1 issues](https://github.com/roots/acorn-mail/issues)[2 PRs](https://github.com/roots/acorn-mail/pulls)MITPHPPHP >=8.1CI passing

Since Mar 6Pushed 1mo 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 1mo ago

READMEChangelog (5)Dependencies (2)Versions (7)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) >= 8.1
- [Acorn](https://github.com/roots/acorn) >= 3.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 encryption from `tls`, you can set the encryption variable:

```
MAIL_ENCRYPTION=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

51

—

FairBetter than 96% of packages

Maintenance84

Actively maintained with recent releases

Popularity39

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 77.1% 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 ~175 days

Total

5

Last Release

102d ago

### 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 (4 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

[tijsverkoyen/css-to-inline-styles

CssToInlineStyles is a class that enables you to convert HTML-pages/files into HTML-pages/files with inline styles. This is very useful when you're sending emails.

5.8k505.3M227](/packages/tijsverkoyen-css-to-inline-styles)[minishlink/web-push

Web Push library for PHP

1.9k12.0M53](/packages/minishlink-web-push)[laravel-notification-channels/twilio

Provides Twilio notification channel for Laravel

2587.7M12](/packages/laravel-notification-channels-twilio)[spatie/url-signer

Generate a url with an expiration date and signature to prevent unauthorized access

4422.3M16](/packages/spatie-url-signer)[mattketmo/email-checker

Throwaway email detection library

2742.0M5](/packages/mattketmo-email-checker)[laravel-notification-channels/discord

Laravel notification driver for Discord.

2371.3M11](/packages/laravel-notification-channels-discord)

PHPackages © 2026

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