Configuration > E-Mail Options

See also Email for more information on customizing your store’s email.

E-Mail Transport Method

Key: EMAIL_TRANSPORT
Path: Configuration > E-Mail Options
Description: Defines the method for sending mail.

PHP is the default, and uses built-in PHP wrappers for processing.
smtpauth should be used by most sites, as it provides secure sending of authenticated email. You must also configure your smtpauth settings in the appropriate fields in this admin section.
Gmail is used for sending emails using the Google mail service, and requires the [less secure] setting enabled in your gmail account.
sendmail is for linux/unix hosts using the sendmail program on the server
sendmail-f is only for servers which require the use of the -f parameter to use sendmail. This is a security setting often used to prevent spoofing. Will cause errors if your host mailserver is not configured to use it.
Qmail is used for linux/unix hosts running Qmail as sendmail wrapper at /var/qmail/bin/sendmail.

MOST SITES WILL USE [smtpauth].

Send E-Mails

Key: SEND_EMAILS
Path: Configuration > E-Mail Options
Description: Send out e-mails?
Normally this is set to true.
Set to false to suppress ALL outgoing email messages from this store, such as when working with a test copy of your store offline.

E-Mail Linefeeds

Key: EMAIL_LINEFEED
Path: Configuration > E-Mail Options
Description: Defines the character sequence used to separate mail headers.

Enable HTML Emails?

Key: EMAIL_USE_HTML
Path: Configuration > E-Mail Options
Description: Send emails in HTML format if recipient has enabled it in their preferences.

Email Archiving Active?

Key: EMAIL_ARCHIVE
Path: Configuration > E-Mail Options
Description: If you wish to have email messages archived/stored when sent, set this to "true".

To view the email archive that is created when this flag is set to true, use the Email Archive Manager.

E-Mail Friendly-Errors

Key: EMAIL_FRIENDLY_ERRORS
Path: Configuration > E-Mail Options
Description: Do you want to display friendly errors if emails fail? Setting this to false will display PHP errors and likely cause the script to fail. Only set to false while troubleshooting, and true for a live shop.

Email Address (Displayed to Contact you)

Key: STORE_OWNER_EMAIL_ADDRESS
Path: Configuration > E-Mail Options
Description: Email address of Store Owner. Used as "display only" when informing customers of how to contact you.

Email Address (sent FROM)

Key: EMAIL_FROM
Path: Configuration > E-Mail Options
Description: Address from which email messages will be "sent" by default. Can be over-ridden at compose-time in admin modules.

Emails must send from known domain?

Key: EMAIL_SEND_MUST_BE_STORE
Path: Configuration > E-Mail Options
Description: Does your mailserver require that all outgoing emails have their "from" address match a known domain that exists on your webserver?

This is often required in order to prevent spoofing and spam broadcasts. If set to Yes, this will cause the email address (sent FROM) to be used as the "from" address on all outgoing mail.

Email Admin Format?

Key: ADMIN_EXTRA_EMAIL_FORMAT
Path: Configuration > E-Mail Options
Description: Please select the Admin extra email format (Note: Enable HTML Emails must be on for HTML option to work)

Send Copy of Order Confirmation Emails To

Key: SEND_EXTRA_ORDER_EMAILS_TO
Path: Configuration > E-Mail Options
Description: Send COPIES of order confirmation emails to the following email addresses, in this format: Name 1 <[email protected]>, Name 2 <[email protected]>

Send Copy of Create Account Emails To - Status

Key: SEND_EXTRA_CREATE_ACCOUNT_EMAILS_TO_STATUS
Path: Configuration > E-Mail Options
Description: Send copy of Create Account Status
0= off 1= on

Send Copy of Create Account Emails To

Key: SEND_EXTRA_CREATE_ACCOUNT_EMAILS_TO
Path: Configuration > E-Mail Options
Description: Send copy of Create Account emails to the following email addresses, in this format: Name 1 <[email protected]>, Name 2 <[email protected]>

Send Copy of Customer GV Send Emails To - Status

Key: SEND_EXTRA_GV_CUSTOMER_EMAILS_TO_STATUS
Path: Configuration > E-Mail Options
Description: Send copy of Customer GV Send Status
0= off 1= on

Send Copy of Customer GV Send Emails To

Key: SEND_EXTRA_GV_CUSTOMER_EMAILS_TO
Path: Configuration > E-Mail Options
Description: Send copy of Customer GV Send emails to the following email addresses, in this format: Name 1 <[email protected]>, Name 2 <[email protected]>

Send Copy of Admin GV Mail Emails To - Status

Key: SEND_EXTRA_GV_ADMIN_EMAILS_TO_STATUS
Path: Configuration > E-Mail Options
Description: Send copy of Admin GV Mail Status
0= off 1= on

Send Copy of Customer Admin GV Mail Emails To

Key: SEND_EXTRA_GV_ADMIN_EMAILS_TO
Path: Configuration > E-Mail Options
Description: Send copy of Admin GV Mail emails to the following email addresses, in this format: Name 1 <[email protected]>, Name 2 <[email protected]>

Send Copy of Admin Discount Coupon Mail Emails To - Status

Key: SEND_EXTRA_DISCOUNT_COUPON_ADMIN_EMAILS_TO_STATUS
Path: Configuration > E-Mail Options
Description: Send copy of Admin Discount Coupon Mail Status
0= off 1= on

Send Copy of Customer Admin Discount Coupon Mail Emails To

Key: SEND_EXTRA_DISCOUNT_COUPON_ADMIN_EMAILS_TO
Path: Configuration > E-Mail Options
Description: Send copy of Admin Discount Coupon Mail emails to the following email addresses, in this format: Name 1 <[email protected]>, Name 2 <[email protected]>

Send Copy of Admin Orders Status Emails To - Status

Key: SEND_EXTRA_ORDERS_STATUS_ADMIN_EMAILS_TO_STATUS
Path: Configuration > E-Mail Options
Description: Send copy of Admin Orders Status Status
0= off 1= on

Send Copy of Admin Orders Status Emails To

Key: SEND_EXTRA_ORDERS_STATUS_ADMIN_EMAILS_TO
Path: Configuration > E-Mail Options
Description: Send copy of Admin Orders Status emails to the following email addresses, in this format: Name 1 <[email protected]>, Name 2 <[email protected]>

Send Notice of Pending Reviews Emails To - Status

Key: SEND_EXTRA_REVIEW_NOTIFICATION_EMAILS_TO_STATUS
Path: Configuration > E-Mail Options
Description: Send copy of Pending Reviews Status
0= off 1= on

Send Notice of Pending Reviews Emails To

Key: SEND_EXTRA_REVIEW_NOTIFICATION_EMAILS_TO
Path: Configuration > E-Mail Options
Description: Send copy of Pending Reviews emails to the following email addresses, in this format: Name 1 <[email protected]>, Name 2 <[email protected]>

Set "Contact Us" Email Dropdown List

Key: CONTACT_US_LIST
Path: Configuration > E-Mail Options
Description: On the "Contact Us" Page, set the list of email addresses , in this format: Name 1 <[email protected]>, Name 2 <[email protected]>

Contact Us - Show Store Name and Address

Key: CONTACT_US_STORE_NAME_ADDRESS
Path: Configuration > E-Mail Options
Description: Include Store Name and Address
0= off 1= on

Send Low Stock Emails

Key: SEND_LOWSTOCK_EMAIL
Path: Configuration > E-Mail Options
Description: When stock level is at or below low stock level send an email
0= off
1= on

Send Low Stock Emails To

Key: SEND_EXTRA_LOW_STOCK_EMAILS_TO
Path: Configuration > E-Mail Options
Description: When stock level is at or below low stock level send an email to this address, in this format: Name 1 <[email protected]>, Name 2 <[email protected]>
Key: SHOW_NEWSLETTER_UNSUBSCRIBE_LINK
Path: Configuration > E-Mail Options
Description: Show "Newsletter Unsubscribe" link in the "Information" side-box?

Audience-Select Count Display

Key: AUDIENCE_SELECT_DISPLAY_COUNTS
Path: Configuration > E-Mail Options
Description: When displaying lists of available audiences/recipients, should the recipients-count be included?
(This may make things slower if you have a lot of customers or complex audience queries)

SMTP Email Account Mailbox

Key: EMAIL_SMTPAUTH_MAILBOX
Path: Configuration > E-Mail Options
Description: Enter the mailbox account name ([email protected]) supplied by your host. This is the account name that your host requires for SMTP authentication.
Only required if using SMTP Authentication for email.

SMTP Email Account Password

Key: EMAIL_SMTPAUTH_PASSWORD
Path: Configuration > E-Mail Options
Description: Enter the password for your SMTP mailbox.
Only required if using SMTP Authentication for email.

SMTP Email Mail Host

Key: EMAIL_SMTPAUTH_MAIL_SERVER
Path: Configuration > E-Mail Options
Description: Enter the DNS name of your SMTP mail server.
ie: mail.mydomain.com
or 55.66.77.88
Only required if using SMTP Authentication for email.

SMTP Email Mail Server Port

Key: EMAIL_SMTPAUTH_MAIL_SERVER_PORT
Path: Configuration > E-Mail Options
Description: Enter the IP port number that your SMTP mailserver operates on.
Only required if using SMTP Authentication for email.

Default: 25
Typical values are:
25 - normal unencrypted SMTP
587 - encrypted SMTP
465 - older MS SMTP port

Convert currencies for Text emails

Key: CURRENCIES_TRANSLATIONS
Path: Configuration > E-Mail Options
Description: What currency conversions do you need for Text emails?
Example = &pound;,£:&euro;,€



Still have questions? No problem! Just head over to the Zen Cart support forum and ask there in the appropriate subforum. In your post, please include your Zen Cart and PHP versions, and a link to your site.

Is there an error or omission on this page? Please post to General Questions on the support forum. Or, if you'd like to open a pull request, just review the guidelines and get started. You can even PR right here.
Last modified September 1, 2020 by Scott C Wilson (063fe7d).