Email Configuration

This section of the Control Panel allows an administrator to set the preferences relating to how email is sent within an ExpressionEngine site. These settings affect not only how emails are sent via the Communicate section of the Control Panel but also how emails are sent for comment and admin notifications and any other email sendings.

Main Screen

The main Email Configuration screen shows a table of all the email preference options. Be sure to contact your host if you have any questions regarding the correct email protocol or settings for your server.

Email Configuration main	screen

Return email address for auto-generated emails

This setting specifies the "From" or "Reply-To" email address to use with system generated emails. With the increase in spam on the internet, many email servers will not accept emails without a valid From or Reply-to address. If you wish to use these various modules and abilities, we strongly recommend filling this field out to prevent your emails from being marked as spam.

Email Protocol

Email can be sent by ExpressionEngine by one of three protocols.

SMTP Server Address

If you chose SMTP as your email protocol above, then you will need to fill out this field, which specifies the server address of the SMTP server. This setting is ignored if "SMTP" is not selected as the email protocol.

SMTP Username

The username used to log in to your SMTP server. Not all SMTP servers require you to authenticate, but many of them do. In those cases you will need to specify the username and password (below).

SMTP Password

The password used to log in to your SMTP server. Not all SMTP servers require you to authenticate, but many of them do. In those cases you will need to specify the username (above) and password.

Use Batch Mode?

The system's mail handling routine allows the use of a "batch mode" whenever it sends email via the Communicate section of your Control Panel. This mode splits up large numbers of emails into small batches which get sent at short intervals. This gives you the ability to send email to very large lists without being in danger of a server time out. By default, PHP limits any process to 30 seconds, which is not enough time to send a large amount of email. By sending email in small batches and reloading a special handler page between batches, server timeouts can be prevented. A secondary benefit is that it is less taxing on your mail server and, in the case of people on shared hosting accounts, less likely to cause problems with your server administrator.

Batch mode is turned off by default in ExpressionEngine. To enable batch mode, you must change the "Use Batch Mode" preference to "Yes" and then set the number of emails per batch in the "Number of Emails Per Batch" preference (below). Please make sure to click the update button to confirm these additions.

Number of Emails Per Batch

This setting is used in conjunction with the "Use Batch Mode?" preference above. This setting determines how many emails will be sent in each batch. The batch size you will be able to use will depend on many things; among them the email protocol you have chosen, the server configuration, and the server power.

If you are using one of the more robust mail protocols, like Sendmail or SMTP, the batch total can be set quite large, possibly as high as several hundred, as these protocols are more efficient. A batch size of 300 in these cases is typical. However, the speed gain in doing so is not significant unless your mailing list numbers in the thousands. If you are using the less efficient "PHP mail" protocol then you will usually need to set a lower batch size; 50-100 is typical.

Default Mail Format

When you send email via the Communicate section of your Control Panel, you are able to send HTML formatted emails. This preference sets whether the Communicate section has "Plain text" or "HTML" selected by default.

Enable Word-wrapping by Default?

When you send email via the Communicate section of your Control Panel, you are able to choose whether to have the email sending routine word wrap the message. This preference sets whether the Communicate section has "Word Wrapping" on by default. For more information about word wrapping please see the Communicate section of the manual

Email Console Timelock

The number of minutes that must lapse before a member is allowed to send another email. Note: This only applies to the Email Console in the member profile pages.

Log Email Console Messages

This preference lets you keep a copy of all messages sent via the Email Console in the member profile pages by logging them.