Announcing Medusa Emails

Transactional emails are a core part of any commerce experience. Customers expect updates on orders, shipments, payments, and more.

Historically, setting up emails in Medusa has required too much work. You had to create an account with a third-party provider, integrate it with Medusa, and bounce between systems to test that things work as expected.

Today, we are excited to announce Emails in Medusa Cloud, aimed at making transactional emails easy to work with. All existing and new organizations on Medusa Cloud are able to send emails with zero configuration needed.

How it works

Emails in Medusa are powered by notification providers. Deploying your application on Medusa Cloud gives you a provider out of the box with zero configuration needed. We automatically register a Medusa Emails provider for you, provided you do not already have a different provider registered. This allows you to send emails simply by creating email notifications in your application:

12345678910
const notificationModuleService = container.resolve(Modules.NOTIFICATION)
await notificationModuleService.createNotifications({
    to: "test@gmail.com",
    from: "notifications@mystore.com"
    channel: "email",
    content: {
      subject: "Order shipped"
      html: "<p>Your order has been shipped</p>",
    },
)

Typically, you want to enrich your emails with data, e.g. to include the order number or shipping information. Medusa Emails works flawlessly with email rendering libraries, such as react-email, allowing you to create on-brand emails. You can read more about this and explore examples in our emails documentation.

Verifying your domain

By default, emails are sent from our domain, medusajsemail.com. This is only meant for testing, and can only send to members of your Medusa Cloud organization. To set up Medusa Emails for production, you need to verify a sender domain. You can do so by navigating to the Emails settings in your Medusa Cloud dashboard:

Once you have added a domain, you are required to add the necessary DNS records to your DNS provider in order to verify the domain:

Once you have added the records, the status of the domain will become Copy to clipboardVerified after a few minutes. From here on you are all set for sending from your domain.

Check out a full guide on verifying a sender domain in our documentation.

Email activity

You will sometimes need to check your sent emails for troubleshooting purposes, or to check how good deliverability is. You can do that on the Activity page which will give you the number of emails sent, deliverability rate, open rate, click rate, and more.

If you click on any single email in the history, you will be able to see the details for it, including a timeline, a preview and the raw HTML:

Quick demo

Here is a quick demo of the dashboard:

With built-in transactional emails in Medusa Cloud, we are removing the tedious parts of setting up a new store. You get reliable, production-ready email flows from day one, without external dashboards or manual configuration.

This is a critical step toward making Medusa Cloud the fastest way to build and operate Medusa applications.