Troubleshooting PrestaShop Email Notification Failures

Common Causes of Email Failures 

• Incorrect SMTP Settings: The most frequent culprit. A single typo in the server address, port, or password can stop emails instantly. 
• Server-Side Restrictions: Many hosting providers, especially on shared hosting, block the default PHP mail() function to prevent spam. 
• Module Conflicts: A newly installed module might be overriding the default email functionality. 
• Spam Filters: Your emails might be sent correctly, but are landing in the recipient’s spam folder
• spam folder due to poor sender reputation or missing SPF/DKIM records.

Step-by-Step Troubleshooting Guide 

1. Check PrestaShop Email Configuration

The first place to look is your store’s back office. 

1. Navigate to Advanced Parameters > E-mail. 
2. You will find three available choices: “Never send emails,” “Use the PHP mail() function,” and “Configure custom SMTP settings.” Ensure “Never send emails” is NOT selected. 
3. Test the Configuration: PrestaShop has a built-in testing tool. Scroll down to the “Test your email configuration” section. Input your email and use the “Send a test email” option to validate the setup. 

•  If it works: This behavior could be caused by specific modules or template-related configurations.
• If it fails: Server or SMTP configuration issues are likely the cause.

2. Configure SMTP Settings (Recommended)

If the default PHP mail() function is failing, or if your emails are going to spam, switching to SMTP is the best solution. 

1. Select “Set my own SMTP parameters”. 
2. Fill in the details provided by your email host: 

• Mail domain name: Leave this empty in most cases. 
• SMTP server: e.g., Use an SMTP server like smtp.gmail.com or mail.yourdomain.com. 
• Encryption: Use TLS or SSL. 
• Port: Usually, TLS operates on port 587, and SSL on port 465. 

3. Save the settings and execute the test again.

3. Verify Server Logs and Error Reporting

If SMTP is set up correctly but emails still fail, you need to dig deeper. 

• Enable Debug Mode: Access Advanced Parameters > Performance and turn Debug mode on. 

Try performing an action that sends an email (like creating a test order). A system error message could be shown on the screen. 

Check Server Logs: Open your hosting control panel (cPanel/Plesk) and review the available error logs. Look for any entries related to `sendmail` or `mail`.

Protecting security is critical. Do not place API keys directly in your source code or include them in repositories managed by version control. Use Magento’s configuration system for encrypted values and environment-specific secrets. Implement rate limiting and quota monitoring, since most LLM APIs charge per token and enforce caps. Add content moderation keyword filtering, length checks, and optional human review to guard against inappropriate or inaccurate output and protect brand reputation.

4. Investigate Module Conflicts

Sometimes, a third-party module designed to customize emails or manage orders can interfere with the core system. 

1. Go to Modules > Module Manager. 
2. Disable non-essential modules one by one, especially those related to mail alerts, newsletters, or order management. 
3. Test email functionality after disabling each module. If emails start working, you have found the culprit.

4. Investigate Module Conflicts

Sometimes, a third-party module designed to customize emails or manage orders can interfere with the core system. 

1. Go to Modules > Module Manager. 
2. Disable non-essential modules one by one, especially those related to mail alerts, newsletters, or order management. 
3. Test email functionality after disabling each module. If emails start working, you have found the culprit.

5. Validate Fixes for Gmail User

If you are using Gmail as your SMTP server, Google has tightened security. You cannot simply use your login password anymore. 

1. Visit your Google Account settings. 
2. Activate the 2-Step Verification feature.
3. Locate the App passwords option.
4. Generate a Mail app password and use the 16-character code for SMTP authentication in PrestaShop.

advanced Fixes: SPF and DKIM 

If your emails are being sent but customers aren’t receiving them, they are likely being blocked by spam filters. To resolve the issue, your domain must be properly authenticated. 

• SPF (Sender Policy Framework): A DNS entry that specifies the servers or IP addresses permitted to send emails for your domain.
• DKIM (DomainKeys Identified Mail): Request your hosting provider to update your DNS configuration with the specified TXT records.

Email logs

Within the Advanced Parameters → E-mail area, PrestaShop also records a history of outgoing emails that can help diagnose delivery problems. When this information is not sufficient, further investigation may require reviewing server-level records such as sendmail or mail service logs, which are outside the scope of PrestaShop’s default administration features.

Common Email Delivery Issues 

Begin by confirming that the “Never send emails” option is not selected in the Advanced Parameters → E-mail section of your PrestaShop back office. 

If this setting is correct, use the following checklist to identify and resolve typical email delivery problems. 

When using Sendmail: 

• Ensure that the sendmail service is enabled on your server. In a VPS environment, you might have to install and configure it manually. 

• Verify that your hosting provider has not restricted outgoing mail services. Some hosts limit email sending even on VPS plans. If this situation occurs, reach out to your hosting provider for clarification or consider using SMTP as an alternative.

When using SMTP: 

• Double-check all SMTP configuration details, including the mail server address, port number, username, and password. 

• Be aware that certain email providers require additional verification or security approval the first time SMTP is used. Follow the setup instructions given by your email service provider.

If only specific emails fail to send: 

• Identify which messages are not being delivered. If the issue affects emails generated by modules, review the configuration of those modules. 

For instance, order notification messages are handled by the Mail Alerts module. Confirm that this module is installed and properly enabled, and that its notification options are turned on.