Configure MODX to email with GMail or G Suite
Configuring MODX to use a personal Gmail or G Suite (formerly Google for Domains) account, or most other SMTP email account for that matter, is straightforward to set up from the MODX Manager.
If using an ESP isn't an option, this method will allow you to have keep a record of what was sent in your Sent folder.
Before starting, you will need the following information in order to configure MODX to send email with your Gmail or other SMTP email account:
- SMTP Server Address
- Email address of the account from which you wish to send
- The password, or an application specific password if you use Google's version of Two-factor Authentication (2fA), called 2-Step Verification
-
Login into the MODX Manager of the website for which you wish to send emails with Gmail, G Suite or other SMTP.
-
At the top right of the MODX Manager, click/hover on the cog icon to reveal the menu.
-
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.
-
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.
-
Complete the setup of your SMTP settings as follows:
SMTP Authentication
= YesSMTP Hosts
= smtp.gmail.com, or your regional-specific hostSMTP Password
= your email password , or the application specific password if you use 2-Step VerificationSMTP Port
= 465SMTP Connection Prefix
= sslSMTP User
= your full email addressUse SMTP
= Yes
Other SMTP servers
The configurations for other local SMTP servers should be similar to the above. Consult your mail administrator for specific settings.
Testing and Troubleshooting
If you'd like to quickly test the email configuration, from the MODX Manager, go to Extras>Install Packages and click Download Packages, to search for and install QuickEmail, place the Snippet call on a page and visit the page. See our guide to Troubleshooting Email Delivery for more information.
Further reading
Two-factor Authentication (2fA), called 2-Step Verification by Google, is a really good thing. You should use it. Read more about Gmail 2-Step Verification, and go set it up, right now.