# mageplaza/module-smtp

> SMTP Extension for Magento 2 helps the owner of store simply install SMTP (Simple Mail Transfer Protocol) server which transmits the messages into codes or numbers

`composer require mageplaza/module-smtp`

Canonical URL: https://packagento.com/mageplaza/module-smtp

## At a glance

- **Vendor**: mageplaza (https://packagento.com/mageplaza.md)
- **Latest version**: 4.7.22 — released 2026-05-22
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/mageplaza/module-smtp and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require mageplaza/module-smtp:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

SMTP Extension for Magento 2 helps the owner of store simply install SMTP (Simple Mail Transfer Protocol) server which transmits the messages into codes or numbers

## README


Every day you send and receive hundreds or more emails, however, you actually do not know whether they will get your targeted customers inbox. So, we offer **Magento 2 SMTP Extension** as a solution for this problem.

**SMTP Extension for Magento 2** allows the owner offer a Magento 2 store to custom **SMTP (Simple Mail Transfer Protocol)** server which transmits email messages. Through the SMTP server, messages will be delivered directly and automatically to the chosen customers. It offers flexible configurations with 21 different *SMTP servers* such as `Gmail, Hotmail, O2 Mail, Office365, Mail.com, Send In Blue, AOL Mail Orange, GMX, Outlook, Yahoo, Comcast, or Custom SMTP` - for your own SMTP server, etc. 

[![Latest Stable Version](https://poser.pugx.org/mageplaza/module-smtp/v/stable)](https://packagist.org/packages/mageplaza/module-smtp)
[![Total Downloads](https://poser.pugx.org/mageplaza/module-smtp/downloads)](https://packagist.org/packages/mageplaza/module-smtp)

![smtp configuration](https://i.imgur.com/GoI1Y7U.png)


### 1. Documentation

- [Installation guide](https://www.mageplaza.com/install-magento-2-extension/)
- [User Guide](https://www.mageplaza.com/magento-2-smtp/user-guide.html)
- [Download from our Live site](https://www.mageplaza.com/magento-2-smtp/)
- [Get Free Support](https://github.com/mageplaza/magento-2-smtp/issues)
- Get premium support from Mageplaza: [Purchase Support package](https://www.mageplaza.com/magento-2-extension-support-package/)
- [Contribute on Github](https://github.com/mageplaza/magento-2-smtp)
- [Releases](https://github.com/mageplaza/magento-2-smtp/releases)
- [License](https://www.mageplaza.com/LICENSE.txt)



### 2. How to install SMTP Extension

#### Install via composer (recommend)

Run the following command in Magento 2 root folder:

```
composer require mageplaza/module-smtp
php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
```


### 3. Highlight features:

#### Flexible Configurations

The **SMTP Extension** is easy and flexible to configure. It's easy for the owner to set or reset any option. It can easily be configured in many different ways to suit your purposes.

#### SMTP Debug mode

The extension offers an useful debugging mode. This allows store owners to test their emails by logging an exact copy of emails sent to customers, including the content. This allows store owners to see and correct any errors in sent emails.
The **Debug mode** allows owners to manage, preview or review the time the email was created. The logs can be deleted either automatically through a cron job or manually.

#### Email logging

All the emails sent out from your store will be kept in the **Magento 2 SMTP extension** log. The Admin can review the content of the email and to whom it was sent. Furthermore, you also check the time sent and the current, status whether it is pending, in process or failed in the list.

#### Test email

This feature allows admin test the [SMTP](https://github.com/magento-2/smtp) Settings and make sure it works for current store.

### Full features of the SMTP Extension for Magento 2

- Use Your Own SMTP Server 
- Sending the test emails before sending officially
- Ensure all emails will be sent to desired customers 
- Email logging with detailed view of every letter
- Delete email log manually
- Debug mode by SMTP email settings to test
- Supports flexible servers
- Check and preview sent emails
- [NEW] Integration with AVADA Email Marketing
- [NEW] Abandoned cart emails
- [NEW] Welcome email to new subscribers, customers



### 4. User Guide


In Magento 2, the default email server is the server installed on the webserver, which means the sender reputation for emails may be low. Low sender reputation may cause emails to be treated as untrustworthy and may be delivered to spam folders. This is undesirable for obvious reasons. Imagine your customers' reaction when important email communication like password resets, transactional emails, shipping notifications and and others are not delivered.

**Mageplaza SMTP** will help you resolve this issue. We make several popular email providers available to configure directly in your magento admin panel. We also provide you with an easy to review log of emails that were sent, including useful details for debugging. Say goodbye to your customers' spam box forever.


#### How to config SMTP

##### 1. Email logs

This can be accessed at `Mageplaza > SMTP > Email Logs`. From here you can see the emails sent from the server to customers.

![How to config SMTP Email logs](https://i.imgur.com/k5KfDLL.png)

By clicking View in each email, you can have an understanding of what the customer will see when they receive the email in their client.
You can hit the Clear red button to clear all the archived emails to clean up your archive when you are done.

![ How to config SMTP order](https://i.imgur.com/5eos9R7.png)

##### 2. Configuration

###### 2.2.1 General Configuration

Log into the Magento administration panel, go to `Mageplaza > SMTP > Configuration > General Configuration`

Choose Yes to enable Mageplaza SMTP.

![ How to config SMTPSMTP on](http://i.imgur.com/4jN9BIx.png)

###### 2.2.2 SMTP Configuration Options

In the general general configuration area, scroll down to the SMTP Configuration Options

![magento 2 smtp configuration](https://i.imgur.com/VnCM6SB.png)

- In SMTP Provider field, choose your provider from one of nearly 30 SMTP email service providers. Click Auto Fill button to fill Host, Port, Authentication and  Protocol automatically, which are compatible with the SMTP provider you had chosen. Alternatively, you can select a custom provider, and fill this information in yourself.

- At Host field, type your Support Host name and ID Address. You can also customize the STMP Provider’s Host name here. If you clicked Auto fill button, you can

_(README truncated for .md surface. Full README on https://packagento.com/mageplaza/module-smtp.)_

## Changelog

CHANGELOG: https://www.mageplaza.com/releases/smtp

## Recent Versions

| Version | Released |
|---|---|
| 4.7.22 | 2026-05-22 |
| 4.7.21 | 2026-01-27 |
| 4.7.20 | 2025-10-28 |
| 4.7.19 | 2025-10-08 |
| 4.7.18 | 2025-08-19 |
| 4.7.17 | 2025-06-18 |
| 4.7.16 | 2025-05-28 |
| 4.7.15 | 2025-04-16 |
| 4.7.14 | 2024-12-03 |
| 4.7.13 | 2024-08-19 |

Showing 10 of 93 versions. Full release history on https://packagento.com/mageplaza/module-smtp.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| mageplaza/module-core | ^1.5.14 |

## Quality

Latest release (4.7.22) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | Pass | Pass |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Fail | 366 | 1 error, 365 warnings (ruleset: Magento2) — 232 auto-fixable with phpcbf |
| PHPMD | Warning | 73 | 73 rule violations (UndefinedVariable:18, CyclomaticComplexity:14, NPathComplexity:13, IfStatementAssignment:10, UnusedFormalParameter:6) |
| Cpd | Pass | 0 |  |
| Composer validate | Info | 1 | valid; 1 advisory note (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | 58 | Unknown | – | – |
| 2.4.8 | – | 58 | 58 | – |
| 2.4.9 | – | – | Unknown | 56 |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 |  |
| Malware scan | Pass | 0 |  |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["mageplaza/module-smtp"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

mageplaza is a Magento 2 vendor on Packagento. See https://packagento.com/mageplaza.md for their full catalogue.