Configure MODX to Use an Email Service Provider

Email Service Providers (ESP) can significantly improve deliverability of email sent from your MODX projects—they don’t end up in spam folders or get blocked by major webmail providers. ESPs also provide deliverability statistics (so you know your messages were actually sent) and bounce handling.

Configuring MODX to use an ESP is straightforward to set up from your Cloud website’s MODX Manager.

Before you start you will need an account with an ESP. Most ESPs offer a free tier that allows you to send 1000s or more emails per month, which should be adequate for many sites’ transaction emails like registration confirmation emails and receipts. Some of the more popular ones include Mandrill (requires paid Mailchimp Account), SendGrid, Postmark, Mailgun, Mailjet and Amazon SES.

If you are already signed up, you need the following information from your ESP before proceeding to configure MODX to send email via the ESP:

  • SMTP Server Address
  • Username (sometimes the API key)
  • Password (often a unique API key)
  • Optional: port number and protocol prefix
  1. Login into the MODX Manager where you wish to add an ESP to for email delivery.

  2. Settings Cog

    At the top right of the MODX Manager, click/hover on the cog icon to reveal the menu.

  3. Click on System Settings

    From the cog menu, click on System Settings and you'll be taken to a page with a grid of various settings and their values.

  4. Enter SMTP into the Search by key field.

    In the field at the top right of the grid that has the placeholder text of Search by key… enter "SMTP" (without the quotation marks) as this will filter all the settings you need.

  5. Complete the setup of your SMTP settings for your ESP as follows:

    • SMTP Authentication should be set to Yes
    • SMTP Password should be set to the password provided by your ESP
    • SMTP User should be set to the username provided by your ESP
    • SMTP Port should be set to the port provided by your ESP
    • SMTP Connection Prefix should be left blank or set to either ssl or tls depending on your ESPs settings. Typically this is tls (Google requires tls).
    • Use SMTP should be set to Yes

    Here's a screenshot example using the information from Mandrill:

    SMTP settings in MODX using Mandrill as an example.

See the screenshots below for some of the more popular ESPs’ settings.

Mandrill (requires paid MailChimp account)
Mandrill SMTP credentials view.


Sendgrid SMTP credentials view.

Postmark SMTP credentials view.

Mailgun SMTP credentials view.

Mailjet SMTP credentials view.

Amazon SES




Have more questions? Submit a request


Please sign in to leave a comment.