Magento: Transactional emails. How add an image from a custom template

Magento: Transactional emails. How add an image from a custom template

July 18, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento: Transactional emails. How add an image from a custom template

Incorporating Images From Your Custom Magento Theme Into Transactional Emails

Transactional emails are an essential part of any e-commerce platform’s communication strategy. They provide customers with important information about their orders, shipments, and account status. In Magento, you have the freedom to customize your transactional emails using templates that can include images from your website’s theme.

Understanding Transactional Email Templates in Magento

Magento allows you to create custom email templates for various transactions such as order confirmations, invoices, and shipping notifications. These templates can be found under System > Transactional Emails in the admin panel.

By default, Magento uses the ‘order’ template for all transactional emails related to orders. However, you can create new templates for each specific event or use the ‘order’ template and modify it to fit your needs.

Adding an Image From a Custom Theme

The main challenge when trying to add an image from a custom theme is pointing Magento to the correct directory of your skin file. Magento uses a specific syntax to locate images in your theme folder, which can sometimes be confusing.

The Correct Syntax for Skin URL in Magento Email Templates

To use an image from your custom theme, you need to follow this syntax:

{{skin url="images/myimage.png" _area="frontend" _theme="mytheme"}}

Here’s a breakdown of the parameters:

  • {{skin url="images/myimage.png"}}: This is the path to the image file within your theme folder.
  • _area="frontend": Specifies that the image should be loaded from the frontend area of your website. The other option is _area="adminhtml", which loads images from the admin panel area.
  • _theme="mytheme": Indicates that the image should be taken from the ‘mytheme’ theme you’ve created.

Note that if your image is located in a subfolder within your theme’s skin/frontend directory, include the full path. For example:

{{skin url="images/myfolder/myimage.png" _area="frontend" _theme="mytheme"}}

Best Practices for Customizing Transactional Emails

  1. Create a New Template: It is generally recommended to create a new transactional email template rather than modifying the default one, especially if you plan on making significant changes. This allows you to revert back to the original if needed.

  2. Keep Your Images Relevant: Make sure the images you include in your emails are relevant and informative for your customers. Avoid using generic or unrelated images that could confuse them.

  3. Optimize Image Sizes: Optimize your images for web use by compressing them and reducing their sizes without sacrificing quality. This ensures quick loading times, which is crucial for a positive customer experience.

  4. Test Your Emails Thoroughly: Magento provides a preview option in the transactional email settings. Use this to test how your custom emails will look on various devices and browsers before sending them to real customers.

Conclusion

Incorporating images from your custom theme into Magento’s transactional emails is a straightforward process once you understand the correct syntax for the skin URL parameter. By following the best practices outlined above, you can create professional-looking emails that enhance your brand image and improve customer satisfaction.

Remember, if you’re looking to take your e-commerce development skills to the next level, consider joining the Magento developer community at Laravel Company. We provide a platform for sharing knowledge, troubleshooting issues, and staying up-to-date with the latest Magento trends and best practices.

Themes Admin Email Orders

Our network