Information for: DEVELOPERS   PARTNERS

About email in Cloud Platform applications

Important

EOL notice! Legacy Email support will reach end-of-life on February 1, 2022. For more information, see Legacy Email Retirement FAQ. To begin configuring Platform Email Service for your application, see Configuring a domain.

Your principal contact email is the default return address for your Cloud Platform applications. The return path is included in the headers of all email sent by your application and appears as the address of the email sender. Email error messages are also sent to this address.

Cloud Platform supports limited outgoing emails per the Acceptable Use Policy, such as Drupal registration confirmation emails and password reset emails. The Cloud Platform email infrastructure is a shared resource, so you can’t send mass emails (such as marketing messages or newsletters). This service is provided as a courtesy and has no uptime or service level agreements associated with it. For any mass mailings that you must make, you should instead use other, external email services or applications with a specified service level for email. For more information, see Using a third-party email service.

For more information about managing outgoing emails, see Troubleshooting Drupal email issues.

The logs for the shared Cloud Platform email infrastructure aren’t accessible to customers.

Configuring the default email return address

If you are a Cloud Platform Enterprise customer, complete the following steps to configure the default email return address:

Note

This feature isn’t available for Cloud Platform Professional.

  1. Sign in to the Cloud Platform user interface and select the application you want to configure.

  2. Select the environment that you want to configure and go to Actions > Configure Environment. Alternatively, click Configuration in the left navigation pane.

    Configure an environment

  3. Navigate to the Advanced tab.

  4. In the Sendmail Path field, enter a sendmail path similar to the following, replacing name@example.com with your desired return address:

    /usr/sbin/sendmail -t -i -f [email protected]
    

    You can also leave this field empty.

  5. Click Save.

Configuring SPF records

To deal with unwanted email, some email infrastructure refuse email with FROM addresses in a domain that comes from an unrecognized mail infrastructure. Email infrastructure uses the Sender Policy Framework (SPF), as defined in RFC 4408, to validate the hosts and domains that are allowed to send email.

If you use SPF records, configure the SPF records to include all of Acquia’s defined SPF records for mail infrastructure as allowed senders for your domain. For detailed instructions, see Configuring SPF records for domains on Acquia Cloud. Acquia doesn’t support allowlisting of its mail infrastructure IP addresses as these IP addresses can change at any time. Acquia supports only SPF allowlisting.

Issues with emails sent by your Drupal application are typically caused by one of two problems:

  • Your email reader or company’s email infrastructure spam filters are blocking messages.
  • Mail infrastructure is blocking messages due to missing SPF records for Acquia’s email infrastructure.