Create a marketing email and go live

Applies to Dynamics 365 for Customer Engagement apps version 9.x

Email is a vital marketing channel for most modern organizations. It's also a core feature of Dynamics 365 for Marketing, which provides tools for creating graphically rich marketing emails with dynamic, personalized content. Dynamics 365 for Marketing can send large volumes of personalized marketing emails, monitor how each recipient interacts with them, drive customer-journey automation based on these interactions, and present results both for individual contacts and with aggregate statistical analytics.


Process overview—to set up and execute a simple email campaign, you must do the following:

  1. Create an email design that delivers your message and includes required elements such as a subscription-center link, your physical address, email subject, and email From address.
  2. Publish the design by selecting Go live. This copies the design to the Dynamics 365 for Marketing email marketing service, which makes the message available for use by a customer journey (but doesn't deliver any messages yet). The go-live process also activates any dynamic code and replaces links with trackable versions that are redirected through Dynamics 365 for Marketing.
  3. Set up a customer journey that, at a minimum, identifies a published target segment and a published email message to deliver to that segment.
  4. Activate the customer journey by choosing Go Live. The journey then drives the email-delivery process and other automation features. It personalizes and sends each individual message, collects interaction data, and can follow up with additional processes based on those interactions.

This exercise describes how to do the first two of these steps. You'll set up the last two steps in the next exercise.

To create a marketing email and go live:

  1. Go to Marketing > Marketing Execution > Marketing Emails. This takes you to a list of existing marketing emails.
    Location of the new-segment button

    On the command bar, select New.

  2. The New Marketing Email page opens with the Select an Email Template dialog box shown. Each template provides a starting point for designing a particular type of message. The template dialog box provides tools for searching, browsing, and previewing your template collection.
    Dialog for choosing an email template

    For this exercise, select the blank template so that you can step through all the required content. Then choose Select to apply the template to your new message.


    Several standard templates are provided out of the box, and you can also create your own templates that feature your organization's graphical identity, required elements, and messaging standards. More information: Create templates for emails, pages, forms, and journeys

  3. The Select an Email Template dialog box closes and the content (if any) from your selected template is copied to your design. At the top of the email designer page are three required fields: Name, Subject, and From. If your browser window is too narrow to show all the fields, you'll also see a down arrow that opens a menu where you can see the fields that didn't fit.
    Fill out these fields for your new email

    Enter the following:

    • Name: This is an internal name for your message. Enter any name that you will easily recognize later.
    • Subject: This is the subject that email recipients will see when they receive the message.
    • From: Select here to choose the Dynamics 365 for Customer Engagement user who email recipients will see as the sender of the message.
  4. In the main part of the page, you now see the design canvas (on the left side), where you can drag, arrange, and enter content. A Toolbox on the right side of the page provides design elements that you'll use to construct your message.
    Add a text element to a new email

    Drag a Text element from the Toolbox tab over to the top of the canvas. When you have dragged the element to a suitable location, a blue shaded region appears. Release the mouse button to drop the element at that location.

  5. When you drop the text element, you'll see some placeholder text within the element and a floating toolbar just below or above it.
    The floating text toolbar

    Select and remove the placeholder text, and then add your own. Use the toolbar buttons to style your text as you would in a text editor like Microsoft Word (point to any toolbar button to see what it does). Most of the buttons are for styling text and paragraphs, but there are also buttons for creating links; entering dynamic text (more on this later); and moving, copying, or deleting the entire text element.


    The very first text that you enter on the page is especially important because most email clients show this as preview text for the messages in their inbox list. Here is how it looks in Microsoft Outlook:

    How email content looks in the Outlook inbox list

    Messages that come from a familiar sender that have an enticing subject and relevant preview text are much more likely to get opened than messages that have just some, or none, of those things.

  6. An easy way to personalize the message is to include the name of the recipient in the greeting. Add the recipient's name as dynamic text by using the assist-edit feature as follows:

    1. Working in the text element you just added, enter a suitable opening such as Dear.
    2. On the pop-up toolbar, select the assist-edit button </>. This opens a drop-down list at your insertion point in the text element. Choose an entity using assist edit
    3. In the assist-edit drop-down list, select Contact. The assist-edit tool enters code that references the contact entity, advances the insertion point to the next position in the code, and opens a new drop-down list that shows each field from the contact entity. Choose a field using assist-edit
    4. In the assist-edit drop-down list, select firstname. The assist-edit tool finishes the code so that it references the first-name field from the contact entity. The full salutation now looks like this: Dear {{contact.firstname}},. (If you prefer, you can enter that code directly without using assist-edit.)


    You might have noticed that the Subject field also has an assist-edit button. This means that you can put dynamic text (including the recipient's name) in the subject too.

  7. The body of all email messages must include both a subscription-center link and your organization's physical address. These are required by law in many jurisdictions, and Dynamics 365 for Marketing won't let you publish any marketing email that doesn't have them. Most templates include them already, but when you're working with a blank template you must add them yourself. Like you did with the recipient's name, you'll place them by using assist-edit as follows:

    1. Choose a suitable location for your physical address, and then use assist-edit to place it. Select msdyncrm_contentsettings in the first drop-down list, and then select msdyncrm_addressmain in the second drop-down list to build the expression: {{msdyncrm_contentsettings.msdyncrm_addressmain}}.

    2. Choose a suitable location for the subscription-center link, and then enter some anchor text there (such as manage your subscriptions). Select the anchor text, and then select the Link button The Link button from the floating toolbar, which opens the Link dialog box. Select the assist-edit button for the Link field, and then select msdyncrm_contentsettings in the first drop-down list and msdyncrm_subscriptioncenter from the second list to build the expression: {{msdyncrm_contentsettings.msdyncrm_subscriptioncenter}}. Select OK to create the link.
      The email Link dialog


      Values that you use often, including required content like the subscription-center link and physical address, are stored in Dynamics 365 for Marketing as content settings. That's why you chose the content settings entity when placing these values by using assist-edit. Content settings provide a central location where you can store and update information that you use in most or all of your messages.

      You can have as many Content Settings records as you like, but many organizations use just one. When you set up a customer journey, you'll also pick the Content Settings record used by all messages sent by that journey. This means that you can reuse the same marketing email in different customer journeys, but dynamic values taken from the Content Settings record can vary based on which customer journey sends the message.

  8. You should usually include at least one visible image in your design because this will invite recipients to load images, which is required for Dynamics 365 for Marketing to log the message-open event. Drag an Image element from the Toolbox onto the canvas. This time, when you drop the element, you'll see an image placeholder and the Properties tab, which shows configuration settings for the selected element.
    Where to set the Source for an image

  9. On the Properties tab, select the Image Gallery button The browse button at the right side of the Source field . The Select an Image dialog box opens.
    The image library browser
    Here you can see all the images that have already been uploaded to your Dynamics 365 for Marketing server. Select an image, and then choose Select to place it in your message design. (If you don't see any images, choose Upload a Picture to add a new one.)


    When a message goes live, Dynamics 365 for Marketing uploads all relevant images from your library to its content-delivery network, where they become available as a single source to all recipients. The images aren't attached to each message, but instead are included as links that are redirected through Dynamics 365 for Marketing for tracking purposes. Recipients won't download any images until they open the message, which saves bandwidth both for you and them. When a recipient's email client requests the images, Dynamics 365 for Marketing knows that the message has been opened, and by whom.

  10. Your message now includes all the minimal required and recommended content, so go to the Preview tab to see an approximation of how it will be rendered on various screen sizes and how its dynamic content will get resolved.
    The email preview and preview settings

    Use the buttons in the leftmost column to choose a screen size and orientation to preview. Use the Contact and Content Settings fields in the Properties column to see how your dynamic content will resolve for various recipients and settings.

  11. To make sure your message includes all required content and is ready to send, select Check for Errors in the command bar. Dynamics 365 for Marketing checks your message, and then displays results in the notification bar. Expand the notification bar to read the results.
    The check-for-errors button and notifications

    If you followed this procedure, your message should pass the error check. If it doesn't, read the error message, fix the reported issue, and try again until it passes.

  12. Until now, your previews and error checks have been simulated. The final test is to deliver the message to yourself, open it in your email program, and inspect the results. On the command bar, select Test Send. A Quick Create form slides in from the side.
    Email test-send settings

    Enter your own Email Address in the field provided, and select the Test Contact and Test Content Settings records to use when resolving dynamic content (these work the same as for the simulated preview). Select Save to send yourself the message. You should receive it in a few minutes.

  13. If your message still looks good after you receive it in your inbox and open it, you're ready to publish it by selecting Go Live on the command bar.
    Location of the Go Live button

    Dynamics 365 for Marketing copies your design to the email marketing service, which makes the message available for use by a customer journey (but doesn't deliver any messages yet). The go-live process also activates any dynamic code and replaces links with trackable versions that are redirected through Dynamics 365 for Marketing (which identifies the recipient and logs the click). Finally, your message Status Reason is updated to Live.


    While the message is live, it's locked for editing in Dynamics 365 for Marketing. If you need to edit a live message, you must first open it in Dynamics 365 for Marketing, and then select Deactivate on the command bar.

See also

Best practices for email marketing
Design your digital content
Keyboard shortcuts and accessibility features for content designers
Prepare marketing email messages
Work with email, page, and form templates
Design elements reference