NestJS Mailer

Appearance

NestJS MailerEmail for NestJS, built on Nodemailer

Use what you need. SMTP or HTTP APIs, sent directly, queued or through an outbox, with sendMail(), mail classes or @nestjs/mail.

Get Started
What's new in v4
Template playground
GitHub
NestJS Mailer

Typed mail classes

Write each email once as an injectable class with typed data, then send(WelcomeMail, { to, data }) from anywhere. Compatible with @nestjs/mail mail classes.

Mail classes

Reliable delivery

Transient failures are retried with backoff, never at the risk of a duplicate. Failover, typed errors, validation, AbortSignal, idempotency keys and graceful shutdown.

Reliability

Works with @nestjs/mail

Give the official @nestjs/mail any nodemailer transport, this module's failover and delivery rules, or Handlebars, Pug, EJS, MJML, Liquid and Nunjucks templates.

Interop

Test mailbox

MailerTestModule runs the real mailer without sending. Assert on recipients, subjects, links and attachments with TestMailbox.

Testing

Previews and dev transports

Browse rendered emails at /_mailer during development, or write them to .eml files or the log instead of sending.

Email previews

Delivery rules

Redirect recipients to a QA inbox in staging, drop suppressed addresses, and add one-click unsubscribe headers for Gmail and Yahoo.

Delivery rules

Multiple template engines

Handlebars, Pug, EJS, Liquid, Nunjucks or MJML, with built-in CSS inlining, i18n and custom template resolvers.

Template adapters

Nodemailer or HTTP APIs

SMTP and every nodemailer transport, or zero-dependency Resend, Postmark, SendGrid, SES, Mailgun and Brevo transports. Named transporters, plugins, health checks.

HTTP transports

Queue or outbox

Send in the request, in the background with BullMQ and scheduling, or after your transaction commits through the official @nestjs/outbox.

Choose how to send

v4 is out

Mail classes, HTTP transports, retries with duplicate protection, typed errors, a transactional outbox, delivery rules, a test mailbox, email previews and interop with the official @nestjs/mail. Every piece is optional: choose your setup. Read the announcement and the migration guide.

Quick Install ​

bash
pnpm add @nestjs-modules/mailer nodemailer

Using an older version? Read the v3 or v2 docs, or see Versions & upgrading.

Released under the MIT License.

Copyright © 2026 Nest Modules