How to Configure Gmail SMTP with Joomla

Gmail SMTP can work for Joomla when the Google account and organization policy permit SMTP submission. Google Workspace environments may also provide administrator-managed relay options, so identify the intended method first.

Confirm which Google sending method you are using

Gmail SMTP can work for Joomla when the Google account and organization policy permit SMTP submission. Google Workspace environments may also provide administrator-managed relay options, so identify the intended method first.

For direct Gmail SMTP, the outgoing server is smtp.gmail.com. Confirm Google’s current port, encryption, authentication, and account requirements before entering credentials.

Configure the Gmail endpoint in Joomla

Go to System → Global Configuration → Server → Mail Settings and select SMTP.

  1. Set SMTP Host to smtp.gmail.com.
  2. Use the secure port and encryption mode required by Google for the account; commonly this is port 465 with implicit SSL/TLS or port 587 with STARTTLS.
  3. Enable SMTP Authentication.
  4. Use the full Gmail or Google Workspace address as the SMTP username.

Use a Google-supported credential

Do not assume the normal Google sign-in password will work in a basic SMTP password field. Accounts using 2-Step Verification may be eligible for app passwords, but Google Workspace administrators can restrict that feature.

Use only an authentication method permitted by the account and organization. If policy requires an authentication flow Joomla’s standard SMTP fields cannot provide, use an appropriate supported mail integration instead of weakening Google security settings.

Align the From Email with Google sender permissions

Set Joomla’s From Email to an address the authenticated Google account is authorized to use. If you need an alias or different sender, configure and verify that identity in Google first.

An unrelated From Email can be rejected, rewritten, or treated differently by Google’s sender policies even when SMTP authentication succeeds.

Send and verify a Joomla test message

Save the settings and use Send Test Mail. If authentication fails, verify the credential type and account policy. If SMTP accepts the message but it is not delivered, investigate quota, sender policy, spam filtering, and the recipient response rather than repeatedly changing the Joomla password.

Keep app passwords and other secrets out of screenshots, tickets, source code, and ordinary documentation. Record only the non-secret working configuration.


Need More Help with Joomla?

Still having trouble? Open a support ticket with QuantaCade Support and we'll be happy to help where we can.

Support priority is given to QuantaCade products, services, and customers. However, we're also happy to assist fellow Joomla users with general Joomla questions and troubleshooting when possible.

QuantaCade is an independent Joomla extension developer and is not official Joomla support. Some issues involving third-party extensions, hosting environments, server configurations, or other systems outside our development control may be beyond what we're able to resolve.

Open a Support Ticket