Tuesday, 13 December 2016

Creating Adobe Experience Manager HTL Components that send Email messages based on templates

You can create an Adobe Experience Manager (AEM) HTML Template Language (HTL) component that lets web site visitors populate a form and submit the data. The OSGi bundle contains a Sling  Servlet that sends an email message to email recipients. The email message is based on an AEM email template that is located in the AEM JCR repository.

An email template is simply a text file located in the AEM JCR. For example, consider the following template.


<b>Time:</b> ${time}
Forum URL: ${host.prefix}${forum.url}
A new reply was posted by ${modifiedBy.fullname} for CQ Forum topic "${topic.subject}".
This is an automatically generated message. Please do not reply. 
Please follow this link to view all replies to this topic.

Email templates are located at the following JCR location: 


An email template is a JCR node of type nt:file. Each node has a text file as shown in the following illustration. 

This development article discusses how to programmatically send an AEM email message that is based on a template. Futhermore, it also discusses how to populate the variables in the template with values. To send email messages that are based on AEM email templates, you use the MessageGatewayService API.  


Join the Experience League

To become an Experience Business, you need more than just great tools and online help. You need a partner. Experience League is a new enablement program with guided learning to help you get the most out of Adobe Experience Cloud. With training materials, one-to-one expert support, and a thriving community of fellow professionals, Experience League is a comprehensive program designed to help you become your best.

Join the Adobe Experience League by clicking this banner.

I (Scott Macdonald) am a Senior Experience League Community Manager at Adobe Systems with 20 years in the high tech industry. I am also a programmer with knowledge in Java, JavaScript, C#,C++, HTML, XML and ActionScript. If  you would like to see more AEM or other end to end articles like this, then leave a comment and let me know what content you would like to see.

Twitter: Follow the Digital Marketing Customer Care team on Twitter @AdobeExpCare.


  1. Hi Scott,

    Is there a way to auto populate all the form fields automatically. Say tomorrow I add a new field is form, then I simply dont want to go and add a new parameter in the email templates.

    Can I use something like a for loop inside the Email template.

    Please advice.


  2. I really appreciate information shared above. It’s of great help. If someone want to learn Online (Virtual) instructor lead live training in Adobe Experience Manager
    , kindly contact us http://www.maxmunus.com/contact
    MaxMunus Offer World Class Virtual Instructor led training on Adobe Experience Manager . We have industry expert trainer. We provide Training Material and Software Support. MaxMunus has successfully conducted 100000+ trainings in India, USA, UK, Australlia, Switzerland, Qatar, Saudi Arabia, Bangladesh, Bahrain and UAE etc.
    For Demo Contact us:
    Name : Arunkumar U
    Email : arun@maxmunus.com
    Skype id: training_maxmunus
    Contact No.-+91-9738507310
    Company Website –http://www.maxmunus.com