Basic Email Troubleshooting

Emails are not being received - deliverability issues

Testing Email

The easiest way to test email from your cart is to create an account in your store using a non-free email address, and then finding that account in Admin > Customers > Customers, and using the Email button on the right sidebar.

Before you start testing

  1. ALWAYS test on a NON-free email address. Do not test with a yahoo, hotmail, msn, aol, etc address exclusively.
  2. You may need to test on multiple email addresses (by creating multiple store accounts) because some email services will drop email before even putting it in the junk folder.
  3. All email settings are shown in the screen Admin > Configuration > Email.

Symptom: Emails sent from the cart are not arriving

Sometimes your mail server configuration requires a particular format in order to send messages. Options to try include:

  1. Enable Emails Must Be Sent From Known Domain so that the “From” address is set properly
  2. Try a different Email Transport method](/user/email/email_transport_method/). Go to Admin > Configuration > Email Options and try them in this order: php, smtp/smtpauth, sendmail, sendmail -f.
  3. With SMTPAuth, you must enter your password in the SMTP Email Account Password field. Has your cPanel password changed recently? If so, you may need to update the value in this field.
  4. Look on your hoster’s control panel and see if you can add SPF and DKIM records yourself to increase your email reputation. In cPanel, this is done using the “Email Deliverability” application. Work with your hoster if you are unsure about this.
  5. ALWAYS check to see whether a junk mail filter, spam block, or other blacklist system may have trapped your message before it could be delivered
  6. Try enabling the Email Archiving feature. (Note: this can chew up server database disk space quickly.) Then use the Email Archive Viewer contribution to check and see whether Zen Cart really processed the email for sending. If it did, then the problem is related to how PHP is processing your messages after they leave Zen Cart.
  7. If the issue is arising from one particular customer, ask them to whitelist email from your domain. For very strict filters, sometimes this is the only way to get through.

Symptom: Email FROM-ADDRESS shows up funny

If your “FROM” email addresses contain extra brackets “)”, this is due to having an incorrectly-formed email address defined in your store Email Address (sent FROM) setting.

Symptom: Contact-Us emails aren’t arriving

  1. the Email From address may be malformed
  2. the Contact Us Pulldown contents may not be formatted properly. Note the required syntax next to the input field.

Advanced Email Troubleshooting




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 (8380a19).