Magento - New Order mail

Magento - New Order mail

July 28, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento - New Order mail

Modifying Magento New Order Email Templates

When it comes to customizing the appearance and content of your Magento store’s order confirmation emails, understanding where each section originates is crucial for targeted changes. In this guide, we’ll focus on identifying and editing the template responsible for generating the items list within the new order email.

The New Order Email Structure in Magento 1.6.2

Magento 1.6.2 follows a hierarchical structure for its transactional emails. The layout of the order confirmation email is composed of several PHP files that call on various templates and blocks to assemble the final message.

Identifying the Items Template File

The items list within your new order email is primarily rendered by two key files:

  • app/design/frontend/base/default/template/sales/order/items.phtml
  • app/design/frontend/base/default/template/sales/order/items.oos.phtml

These templates are responsible for displaying the product information, including SKU, name, quantity, price, and other relevant details. The first file (items.phtml) is used for in-stock items, while the second one (items.oos.phtml) handles out-of-stock items.

Key Sections of the Items Template

The items.phtml template contains several sections that format the order item data:

<div class="item-info">
    <span class="no-display"><a href="<?php echo $this->getItemUrl($item) ?>"><?php echo $this->escapeHtml($item->getName()) ?></a></span>
    <?php if ($options = $this->getOptionsHtml($item)): ?>
        <div class="item-options"><?php echo $options; ?></div>
    <?php endif; ?>
    <?php if ($description = $this->getItemDescriptionHtml($item)): ?>
        <div class="item-description"><?php echo $description; ?></div>
    <?php endif; ?>
</div>

The Process of Generating the Items List

The items list is populated within your order email using a combination of PHP logic and XML layout updates:

  1. PHP Logic: The Mage_Sales_Block_Order_Item_Renderer class in app/code/core/Mage/Sales/Block/Order/Item/Renderer.php handles the rendering of each individual item.

  2. XML Layout Updates: The layout file for order emails is located at app/design/frontend/base/default/layout/sales.xml. Within this file, you can find XML updates that instruct Magento on how to include and render specific blocks (including the items block) within your order confirmation email template.

Editing the Items Template

To edit the items template:

  1. Navigate to app/design/frontend/<your_theme>/template/sales/order/items.phtml.
  2. Make a copy of this file as a backup.
  3. Open the copied file in your preferred code editor and make the desired changes, ensuring you maintain proper PHP syntax.

Important Note: Before making any modifications, always create a backup to safeguard against potential data loss or issues that may arise from incorrect changes.

Conclusion

Understanding the files responsible for rendering the items list within Magento’s new order email is a vital step in customizing your store’s customer communication. By targeting the items.phtml template and its corresponding PHP classes, you can tailor the appearance of your order confirmation emails to match your brand’s unique style.

Remember, proper backup and testing are essential when editing core Magento files. For more advanced customizations or assistance with complex Magento issues, consider reaching out to a professional development team like Laravel Company.

With this knowledge in hand, you’re now equipped to efficiently modify the items section of your Magento 1.6.2 new order emails and enhance the customer experience within your e-commerce platform.

Magento 1 Catalog Themes Email

Our network