Looking for the v10 manual? Visit our new user's guide!
Search Descriptions Version
This article applies to: ML8

Email Setup

From the Configuration menu, click Email.

This page lets you set up and test your email settings to verify that everything is working properly for your outgoing emails. Enter the necessary values and click the test button, and the store will attempt to send outgoing mail. If everything goes well you'll see a message indicating success. If there is a problem, the store will attempt to display any error messages returned by the mail server.

NOTE: If you receive an error message from the mail server, you will need to contact whoever maintains that mail server for assistance with correcting your email settings. AspDotNetStorefront cannot advise you on what to change.


On the Simple tab, simply fill in the few values listed and click 'Send Test' and the software will try to send 3 emails - a receipt, an admin notification, and a shipping notification. The software will use the default values for all settings except the ones you specify.

NOTE: Clicking 'Send Test' saves the entered values to the storefront AppConfigs (see below).


On the Advanced tab, you can test each of the 3 emails separately, and use different values for each if desired.

NOTE: Clicking 'Send Test' saves the entered values to the storefront AppConfigs (see below).

Manual Configuration

If you prefer to configure email manually, it can be done directly through the AppConfigs. Make sure that all of the "GotOrder," "ReceiptEmail," and "MailMe" AppConfigs are configured properly for your email accounts and mail servers. These include:

MailMe_UseSSL (optional)
MailMe_Port (optional)


NOTE: The software uses System.Net.Mail for outgoing emails. This only supports "explicit SSL" and will fail if your SMTP is set to use SSL on port 465. Please use TLS/STARTTLS on port 587 instead if possible (you still need to select the "Mail Server Requires SSL" YES)

The best way to troubleshoot email issues is to pull up a test order on the Order page and click the "Resend Receipt Email" button. The software will attempt to send that email, and display any errors encountered on the screen. This will often give an indication of where the issue is.
If emails are not being sent, check that there are no AppConfigs that are preventing them from being sent. Some of these are:


Free email accounts like Gmail, Yahoo, and Hotmail often filter out storefront emails, preventing your customers from getting messages you send. Some ways to prevent this are:

Ensure your domain/IP is not on a blacklist from these mail providers
Ensure your emails are being sent from valid email addresses
Implement one of the many ways to verify that you are a legitimate sender
Sender Policy Framework, Sender ID, DomainKeys, Identified Mail, etc
Verify that reverse DNS lookups resolve to your site properly
Disable recursion on your server

Note: ASPDNSF cannot determine if these are necessary for you or provide any assistance with setting them up. Contact your host/IT department for assist with this.