Hacking Sitecore and Life one pipeline at a time!

Sending Your First Email: Part 3

Sending Your First Email Continued

Day 7 brings us Part 3 of the mini-series in the 25 Days of Sitecore EXMSending Your First Email which is designed to be a short, step by step guide for creating your first Sitecore Email Experience Manager message. Today we’re focusing on editing our Hello EXM World message in EXM using the EXM Experience Editor.  

Let’s start off by bringing our message back up! If you recall from yesterday’s post, we walked through how to dig the message out of the Draft’s folder in EXM. Go ahead and click on our message and then click on the Message tab.

EXM Experience Editor Slowness

After clicking on the Message tab when editing a message in EXM, it’s possible that it takes a few seconds (or longer) for the message preview to actually show. This is because it’s the first time that Sitecore has loaded the libraries needed to support Experience Editor and it might take a bit longer. If this happens to you, try refreshing the page. Once it works, it works fast.

Message Tab – In Detail

The Message tab has quite a bit going on in a small amount of space. Let’s explore each item on the tab. The numbers in the lists below match the purple tags in the screenshot.

Message Controls

The message controls show up on all tabs.

1. Root Manager Switcher

The Root Manager Switcher allows the author to swap between root managers if there are more than 1.

2. Language Selector

If your Sitecore instance is configured with multiple languages, this allows you to select the language you want to edit the message item in.

3. Email Campaign Actions

This is a small menu that reveals the duplicate email campaign action. 


4. Message Variant Bar

The Message Variant bar shows any variants that might be in the message. Variants are used when wanting to do A/B Testing within EXM Messages. You can specify multiple variants in the same email message that can have different content in each variant. During dispatch, if multiple variants are being used, you have the option to set up the A/B testing rules for dispatch.

Clicking the plus button in the Message Variant Bar will add a variant to the EXM message. 

Message Details Function Bar

5. Duplicate Variant 

This button, when clicked will duplicate the current variant message and create a new variant using the same content.

6. Edit Message Body

Clicking the Edit Message Body button will open up the message for editing. This mode opens the EXM Experience Editor window.

7. Preview Message as Specific Contact

This action allows the author to view the message in preview mode as a specific recipient that is in the Included Recipients list.

8. Message Details Options Menu

Most of the options in this drop down are easy to understand their function. There is a cool option here, where you can ADD buttons to the Message Details bar by selecting the star next to a function. This adds a button to the bar as a quick action.

Additionally, the Insert token action is special.  When a text field is selected (like the Subject Line) and this action is clicked, it opens up a list of Token personalization options that can be selected.  Tokens are replaced during dispatch with data from the Recipients xDB Contact facet.  Tokens can be used ANYWHERE in a message (including the Message Body).

Tokens are formatted and look like this: $tokenname$. So for example, as shown below in the Insert Token selection box, choosing Firstname will add $firstname$ token to the selected field.

Token Personalization Is Extendable

A Developer can extend and add custom tokens for use in EXM Token Personalization. Doing so is a rather involved process, however Sitecore does have really great documentation on how to create custom tokens.

9. Subject Line

Hello! This is the actual Subject line that Recipients receiving this email will read. Go ahead and put in an interesting subject line. For the purposes of this example, we’re going to put in the following:

Hello $firstname$! Welcome to Emails by EXM!

Token Reformatting

When using a token in the Subject line, the $$’s are removed. So our Subject, after copying in our subject line above, $firstname$ is reformatted to look like Firstname

10. Message Body

The message body is the actual preview of the message being sent. This box is just a preview. Clicking ANYWHERE in the message body will open up the EXM Experience Editor.

Editing the message is identical to the editing the experience of a page item in Sitecore. You have the same options, like personalizations, placeholders, and components.  Components have data sources. Rich text boxes will open up the Rich Text Editor. 

Save The Message Often

When making big changes, like swapping out or adding components to the message, make sure to save the message often to ensure that the presentation information is always up to date. Using the save icon in the top left, is the easiest way to save.

Feel free to spend some time working in the Experience Editor editing the Sample Newsletter email template. Add a picture. Links, etc, to get an idea on how the editor works. Once you have your test message changes complete, click the Save and Close button.

11. Alternative Text

Not all email clients are capable of rendering HTML content. In those cases, the client looks for the alternative text message text that it can render. This field is a TEXT/ASCII field only. An example would include text readers.

Save Your Work!

Don’t forget to hit the big blue Save button once you are done editing your message. This allows you to leave EXM and do something else. and then come back where you left off. Which we’ll do tomorrow!

Anatomy of an Email Message

When editing a message in Sitecore Email Experience Manager, changes are actually being saved to a Sitecore item, just like editing any other Sitecore item. There are specific parts to an email message to know about.  As the image below shows, this is the tree structure for our Hello EXM World message.

1. Message Item

This is the primary Message Item representing an EXM Email Message. The Item ID of this item is the Guid ID used whenever this email message needs to be referenced. Information saved on the General and Recipient Tabs are saved on this item in associated fields.

2. Message Root

The immediate child item of any Email Message Item is the Message Root. This is the item that is considered the Layout Item that contains the Presentation settings of the email. When editing the message body of an EXM Message, this is the item being saved to when presentation changes.

3. Data Source Items

Components defined on the Message Root keep their associated Data Source items as children of the Message Root. All of the items presented are simply data sources for the components.

Email Templates

Email Templates are nothing more than Branch Templates defined in the Templates folder.  Message Item branch templates go ahead and include all of the child data source items in the Branch Template. This allows a developer to create a custom Message template with presentation and data sources completely baked in and ready for content entry.

This completes our run down of the Message tab in an EXM Message and concludes Day 7! I hope that you are enjoying this series! Tomorrow, we detail out the Delivery tab and perform our first EXM Dispatch! Woot!

Don’t forget to register for my Sitecore EXM webinar on December 13 EXM Live! An Email Automation Experience!

Register for EXM Live! Webinar

To register for this webinar, visit https://dx.connectivedx.com/2018-exm-webinar

Tagged as: ,

Categorised in: EXM, Sitecore

2 Responses »


  1. Creating A Custom Email Template: Part 1 | Sitecore Hacker
  2. 25 Days of Sitecore EXM | Sitecore Hacker

Leave a Reply

Please log in using one of these methods to post your comment:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Enter your email address to follow this blog and receive notifications of new posts by email.

Join 1,238 other subscribers

Blog Stats

  • 132,847 hits
Follow Sitecore Hacker on WordPress.com
Sitecore® and Own the Experience® are registered trademarks of Sitecore Corporation A/S in the U.S. and other countries.  This website is independent of Sitecore Corporation, and is not affiliated with or sponsored by Sitecore Corporation.
%d bloggers like this: