SMTP User Guide
Reliable transactional email — presets, test-send verification, per-store senders and delivery logs.
Why your store needs SMTP
Order confirmations, password resets, shipping updates — your store's most important emails are transactional, and they need a real mail server to be delivered reliably. Left on Magento's default mail handling, those messages often fail or land in spam. The SMTP module routes all outbound mail through a proper SMTP service of your choice, with provider presets, a test-send button, per-store sender identities and full delivery logging.
Configuration
Stores → Configuration → Cabbage Patch Studios → SMTP.
| Setting | What it does | Default |
|---|---|---|
| Enable SMTP | Replaces Magento's default mail transport. | No |
| Provider Preset | Auto-fills host, port, protocol and auth for a common provider (or choose Custom). | Custom |
| SMTP Host / Port | Your mail server and port (25, 465 or 587). | — / 587 |
| Encryption | None, SSL (465), TLS or STARTTLS (587). | TLS |
| Auth Method | None, LOGIN, PLAIN, CRAM-MD5 (OAuth 2.0 on Pro). | LOGIN |
| Username / Password | Your SMTP credentials. The password is encrypted at rest. | — |
| Return-Path / From Override | Bounce address; force a specific From on all mail. | — |
| Enable Logging / Retention | Log sent mail; auto-delete after N days. | Yes / 30 |
| Test Connection | A button that runs a full SMTP handshake and reports success and response time. | — |
Provider presets
Pick a preset and the connection fields fill themselves in — you only add your username and password.
| Provider | Host | Port | Encryption |
|---|---|---|---|
| SendGrid | smtp.sendgrid.net | 587 | TLS |
| Mailgun | smtp.mailgun.org | 587 | TLS |
| Postmark | smtp.postmarkapp.com | 587 | TLS |
| Amazon SES (Sydney) | email-smtp.ap-southeast-2.amazonaws.com | 587 | TLS |
| Brevo | smtp-relay.brevo.com | 587 | TLS |
| Mailjet | in-v3.mailjet.com | 587 | TLS |
| Gmail / Google Workspace | smtp.gmail.com | 587 | TLS |
| Microsoft 365 | smtp.office365.com | 587 | STARTTLS |
| Self-hosted / Custom | your server | 587 | STARTTLS |
Other presets include Zoho, SparkPost, Elastic Email, SMTP2GO and Outlook.com — eighteen in total.
Setting it up
- Get SMTP credentials from your provider (often an API key used as the password).
- In SMTP, set Enable SMTP to Yes and choose your Provider Preset.
- Enter your Username and Password.
- Click Test Connection — you should get a success message with a response time.
- Click Save Config, then trigger a real email (e.g. a password reset) and check it arrives.
- Confirm it's logged under Marketing → SMTP → Email Logs with status success.
Per-store senders & the admin fallback
Configure SMTP at Default Config to cover every store and your admin/system emails (password resets, low-stock alerts). Per-website overrides then tailor customer emails for a specific brand, and per-store-view overrides are available on Pro.
FAQ
Port 587 or 465? Use 587 (TLS/STARTTLS) for new setups — it's the modern standard. 465 (SSL) is older but still works. Avoid 25 for external providers; ISPs often block it.
"Authentication failed" on the test? Double-check the username/password (no stray spaces), the auth method, and that your provider allows SMTP. Gmail and Microsoft 365 require an app password (or OAuth on Pro), not your normal account password.
My mail still goes to spam. SMTP delivers; inbox placement depends on your domain's email authentication. Set up SPF, DKIM and DMARC in your DNS (your provider supplies the records). The module logs delivery results, but authentication is configured at the domain level.
Logs filling up? Set Log Retention to a sensible window (e.g. 30 or 90 days); a daily cleanup removes older entries.
Changelog
This guide is itself a Lurox page. Every revision is a published version in Lurox's built-in content history, so we can roll any guide back to an earlier version at any time. The public changelog below tracks what changed and when.
30 June 2026
- Added an annotated screenshot of the configuration screen.
30 June 2026
- Initial publication: configuration, provider presets, setup walkthrough, per-store senders and the admin-scope fallback, plus deliverability FAQ.
Explore the rest of the library
Browse every Cabbage Patch Studios user guide in one place.
All User Guides