Magento core/email_template_mailer not send mail for a custom module

Magento core/email_template_mailer not send mail for a custom module

August 6, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento core/email_template_mailer not send mail for a custom module

Solving Magento Email Template Sending Issues for Custom Modules

Introduction

When developing custom modules for Magento, sending emails via HTML templates can sometimes present challenges despite correctly configuring the email template in the config.xml file. In this blog post, we’ll diagnose and resolve a common issue where the core Magento email template mailer (core/email_template_mailer) fails to send an email for a custom module.

The Issue at Hand

The developer has created an email template for their custom “Vendor” module using the core/email_template_mailer model. The HTML template is properly configured in the config.xml, but the email does not get sent when the sending code is executed. Let’s examine the provided code and identify the potential issues.

Identifying the Problem

Step 1: Inspecting the Config.xml Configuration

The provided configuration looks correct at first glance:

<template>
    <email>
        <vendor_create_account_email_template translate="label" module="vendor">
            <label>New account</label>
            <file>vendor_account_new.html</file>
            <type>html</type>
        </vendor_create_account_email_template>
    </email>
</template>

The template is named vendor_create_account_email_template, has a label of “New account”, uses the file vendor_account_new.html, and specifies that it’s an HTML template.

Step 2: Analyzing the Email Sending Code

The sending code appears to be following the standard Magento approach:

$vednor = Mage::getModel('vendor/vendor')->load(66);

$mailer = Mage::getModel('core/email_template_mailer');
$emailInfo = Mage::getModel('core/email_info');
$emailInfo->addTo($vednor->getEmail(), $vednor->getName());
$mailer->addEmailInfo($emailInfo);

// Set required params and send emails
$mailer->setSender('amit@gmail.com');
$mailer->setStoreId(1);
$mailer->setTemplateId('vendor_create_account_email_template');
$mailer->setTemplateParams(array('vendor' => $vednor));
$mailer->send();

The developer is correctly setting the email template ID, sender details, store ID, and template parameters before attempting to send the email.

Potential Causes of the Issue

Given that both the configuration and sending code seem valid, there are a few potential causes for this issue:

  1. Email Template File Path: Ensure that the vendor_account_new.html file exists in the correct location (app/locale/en_US/template/email/vendor/). Double-check the file name and path against your actual setup.

  2. Sender Email Address: Verify that the specified sender email address (amit@gmail.com) is valid and not being filtered as spam by the recipient’s server. Consider using a domain-specific email address instead, such as noreply@yourdomain.com.

  3. Email Template Content: Inspect the contents of the vendor_account_new.html file to ensure it follows proper HTML formatting and doesn’t contain any errors that might prevent rendering or sending.

  4. PHP Error Logs: Check your Magento PHP error logs for any relevant error messages or warnings that could indicate issues with email sending, such as SMTP configuration problems or permission-related errors.

Solution 1: Verify the Email Template File and Path

To confirm that the template file exists in the expected location:

  1. Navigate to app/locale/en_US/template/email/.
  2. Look for a folder named after your module’s package (e.g., “Vendor_YourModule”).
  3. Inside this folder, ensure you see the vendor_account_new.html file.

If the file is missing or located elsewhere, update the configuration and sending code accordingly to match your actual file path.

Solution 2: Check SMTP Configuration

Ensure that your Magento store’s email configuration (System > Configuration > General > Stores > Email Options) includes valid SMTP credentials. Test the connection by clicking “Send Test Email” to confirm successful email delivery.

Solution 3: Inspect the HTML Template Content

Open the vendor_account_new.html file and check for any syntax errors, missing quotes, or improper formatting that could prevent proper rendering or sending. Ensure that all placeholders (e.g., {{var vendor.name}}) are properly enclosed within curly braces and have valid data being passed from your PHP code.

Conclusion

When facing email sending issues with custom Magento modules using the core email template mailer, it’s essential to follow a systematic approach:

  1. Verify the email template configuration in the config.xml file.
  2. Check the physical existence of the HTML template file against the specified path.
  3. Ensure proper sender details and SMTP configuration for email sending.
  4. Inspect the HTML content of the email template for syntax errors or missing data.

By following these steps, you should be able to identify and resolve most common issues related to Magento core/email_template_mailer not sending emails for custom modules.

If you found this post helpful, feel free to explore more articles on Laravel Company’s blog for insights into Magento development best practices and problem-solving techniques.

Extensions Themes Configuration Email

Our network