Configure SMTP for outbound emails

You can modify the mail settings in the “System Settings” menu, as shown in the images below.

MODX email configuration

MODX email configuration

The options that you must modify with your email provider settings are:

SMTP Authentication: Yes
SMTP Connection Prefix: "ssl" or "tls"
SMTP Hosts: your email provider host.
SMTP Port: your email provider port.
SMTP User: your email user.
SMTP Password: your email password
Use SMTP: Yes

To test your email settings, you can install the “Quick Email” plugin. Once it is installed, go to the home page, add “!QuickEmail? &debug=`1`” to the page content, and save the page.

Once you browse to the home page, the plugin will try to send an email with the one you provided during the installation. This address can be modified by clicking on the user name at the top right corner of the dashboard.

To configure the application to use other third-party SMTP services for outgoing email, such as SendGrid, refer to the FAQ.

NOTE: If you are using Gmail as the outbound email server and have experienced issues trying to send emails correctly, check the Gmail SMTP troubleshooting page to learn the causes of these issues and how to solve them.

Last modification January 18, 2019