Troubleshooting

Problems with e-mails

 

If you do not receive newsletter e-mails, please check the following:

 

1.The newsletter issues are sent out using a scheduled task that is executed every 1 minute by default. You may need to wait for up to 2 minutes before you receive newsletter issue e-mail. The scheduled task status can be checked in CMS Desk -> Administration -> Scheduled tasks.

 

2.Go to CMS Desk -> Tools -> Newsletter -> Newsletter queue. If some e-mail failed, you will find here the exception. After you resolve the technical issue, you can resend all failed e-mails by clicking Resend all failed.

 

3.Make sure you're using correct e-mail addresses.

 

4.Make sure the newsletter issue is not blocked by some antispam software.

 

5.Go to Site Manager -> Settings -> E-mails and make sure your SMTP server is configured correctly You can find some additional details on SMTP server configuration in chapter SMTP server configuration. You can also test e-mail settings in Site Manager -> Administration -> System -> E-mail.

 

Newsletter e-mails debugging might be helpful when solving problems with newsletter e-mails. To enable it, add the following keys to the web.config file of your web project. The first key enables logging of all sent e-mails to <web root>/AppData/logemails.log. The second key causes that all sent e-mails will be logged, but not actually sent. This is helpful when you need to test the functionality but do not want the testing e-mails to be really sent.

 

<add key="CMSLogEmails" value="true"/>

<add key="CMSDebugEmails" value="true"/>

 

Problems with unsubscription links

 

If you encounter problems with unsubscription link resolving, you should set the Base URL property of the newsletter. This property can be set in CMS Desk -> Tools -> Newsletter, if you choose to Edit (Icon_Edit) the newsletter and switch to its Configuration tab.

 

Problems with role subscribers

 

If you have a user role set as a subscriber for your newsletter, it is highly recommended to send the newsletter issues via the e-mail queue in order for the issues to be successfully sent to all members of the user role. To set the newsletter for using the e-mail queue, go to CMS Desk -> Tools -> Newsletter, choose to Edit (Icon_Edit) your newsletter, switch to its Configuration tab and check the Send issues via e-mail queue check-box.