Magento: adding pdf invoice to invoice email

Magento: adding pdf invoice to invoice email

July 12, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento: adding pdf invoice to invoice email

Solving Email Attachment Challenges: Adding PDF Invoices to Magento

Are you looking to enhance your Magento store’s email functionality by including invoices as attachments? You’re not alone! Many merchants want to provide customers with easy access to their receipts and order details right in the confirmation emails. Let me guide you through the process of adding a PDF invoice attachment to transactional emails in Magento.

Understanding the Email Generation Process

Before we dive into code changes, it’s essential to understand how Magento generates emails:

  1. Email Templates: Magento uses various email templates for different types of notifications like new orders, invoices, shipments, and more.
  2. Email Sending: When an event triggers (like creating an invoice), the Mage_Core_Model_Email_Template class is used to send emails using the appropriate template.

Identifying the Relevant Files

You mentioned that you’ve tried changing some core files like /Mage/Sales/Model/Order/Invoice.php, /Mage/Core/Model/Email/Template.php, and /Mage/Core/Model/Email/Template/Mailer.php. You’re on the right track!

For adding attachments, the key file is actually Mage_Core_Model_Email_Template_Mailer::getMailConstructor(). This method is responsible for creating the email message object before sending it.

Generating and Attaching the PDF Invoice

To generate a PDF invoice and attach it to an email, we’ll need to:

  1. Generate the PDF: Use Magento’s built-in Mage_Sales_Model_Order_Pdf_Invoice model to create the invoice as a PDF.
  2. Attach the PDF: Add the generated PDF as an attachment to the email message.

Modifying the Email Template and Mail Constructor

To achieve this, we’ll make changes in two places:

  1. In your custom theme’s template/email/sales/order_invoice.html, add the following line after the invoice table:
{{var order.getPdfInvoice()}}
  1. Override the Mage_Core_Model_Email_Template_Mailer::getMailConstructor() method in a local extension or by subclassing it via your theme.

Here’s an example of how to override and add the attachment:

public function getMailConstructor()
{
    $mail = new Zend_Mail('utf-8');
    $mail->setBodyHtml($this->_getMessage()->getBodyHtml());

    // Generate PDF Invoice
    $invoicePdfTxId = Mage::getModel('sales/order_pdf_invoice')->getInvoicePdf(
        $this->_getEntity()->getId(),
        $this->_getEntity()->getOrder()->getStore()
    );

    if ($invoicePdfTxId) {
        // Attach the PDF to the email
        $mail->createAttachment($invoicePdfTxId, Zend_Mime::TYPE_APPLICATION_PDF, Zend_Mime::DISPOSITION_ATTACHMENT, 'Invoice.pdf');
    }

    return $mail;
}

Conclusion

Adding a PDF invoice attachment to Magento transactional emails is a valuable feature for enhancing the customer experience. By understanding the email generation process and making strategic changes in key files, you can achieve this without relying on third-party extensions.

Remember to always test thoroughly after making code changes, as it affects critical communication with your customers. If you find yourself needing more advanced customizations or facing complex challenges, don’t hesitate to reach out to experts or consider hiring a professional developer for your Magento store.

Happy coding!

Themes Email Orders Customers

Our network