Set up subscription lists and subscription centers

Applies to Dynamics 365 (online), version 9.x

[This topic is pre-release documentation and is subject to change.]

A subscription center is a marketing page that known contacts can use to manage their communication preferences and contact details with your organization.

All marketing email messages that you create by using Dynamics 365 for Marketing must include a link to a subscription center, and they will fail the error check if you try to go live with a message that lacks this link. There are two good reasons for requiring a subscription center link in all marketing email messages:

  • Legal requirements: Many countries/regions have laws that require all marketing email messages to include an unsubscribe link.
  • Deliverability: Spam filters and internet reputation monitors can identify marketing email messages, and might remove those that don't include an unsubscribe link.

All subscription centers include a do not email check box. When a contact chooses this option, the do not bulk email flag gets set on his or her contact record and Dynamics 365 will never send any marketing email messages to that contact. Optionally, your subscription center can present several additional subscription options, such as a list of available newsletters. By presenting several different mailing lists on your subscription center, you gain an opportunity to learn more about your contacts' specific interests while also giving contacts more options beyond the legally required "do not bulk email" option.

Each subscription list exists as a static marketing list in Dynamics 365, while do not bulk email is an explicit attribute of the contact entity. That means that do not bulk email overrules subscription list memberships, but it also means that list memberships will be reactivated if a contact later clears do not bulk email.

The only way a contact can access a subscription center is by clicking a link sent to them in email. Email links are always personalized for the recipient, which means that Dynamics 365 always knows which contact has requested the subscription center and therefore populates it with that contact's current details and subscriptions. Note that you can also add subscription lists to standard marketing pages, which enables inbound (previously unknown) contacts to sign up for one or more mailing lists at the same time they register with your site.

A default subscription center is provided with Dynamics 365 for Marketing, but it is very simple: it includes the minimum contact fields and the required do not bulk email check box. In this exercise, we'll walk through the process of creating a subscription list and adding it to a subscription form. We'll also point out how to choose a subscription center in content settings and how to assign content settings to a customer journey.

Create a subscription list

Subscription lists are based on the standard (static) marketing lists feature of Dynamics 365. To create one:

  1. In Dynamics 365, open the app selector, and then select the Surveys app module. (Marketing lists aren't included in the current version of the Marketing work area, so one place you can find them is in the Surveys app, which is included with Dynamics 365 for Marketing.)
    How to open the surveys app

  2. The navigator for the Surveys app is a bit different from the Marketing app: it's horizontal and displayed at the top of the screen. Use it to navigate to Marketing > Customers > Marketing Lists.
    How to open marketing lists in the surveys app

  3. You now see a list of existing marketing lists, if any. On the toolbar, select New to create a new list.

  4. The New Marketing List page opens.
    How to configure a list as a subscription list

    Make the following settings (at minimum):

    • Name: Enter a descriptive name
    • Subscription: Set to True.


      When you set Subscription to True, the List Type is automatically set to Static and Targeted At is automatically set to Contact. Both of these settings are consistent with the requirements of a subscription list, and they remain locked unless you change the Subscription setting.

  5. On the command bar, select Save to save your new subscription list.

Add a subscription list to a subscription form

Now that you have a subscription list available, you can add it to a subscription form. The procedure is nearly the same as when you add other types of input fields to a form.

  1. If you are still in the Surveys app, use the app selector to go back to the Marketing app.

  2. In the Marketing app, go to Marketing > Internet Marketing > Marketing Forms.

  3. You now see a list of forms. On the command bar, select New to create a new one.


    You could instead edit an existing form by choosing it from the list, but for this exercise we'll describe how to create a new one. Note that if you edit an existing form, your edits will affect all marketing pages that use that form because forms are imported by reference, not copied to the page like template content.

  4. The Select a Form Template dialog box opens.
    How to find a subscription center template

    Do the following:

    • It's important to select a template of the correct type (subscription center), so start by filtering the template list by choosing the Type tab, and then choose Subscription center from the drop-down list here.
    • Choose a template (we'll show the 1-Column Subscription Center for this exercise), and then choose Select.
  5. Your selected template is now copied to your new form design.
    Edit the heading inserted by the form template

    As you can see, the template has already provided the following:

    • A basic contact-information form that includes several typical fields
    • A Do not email check box (which is required for all subscription forms)
    • A Submit button (which is required for all forms)
    • Two headings with placeholder text surrounded with square brackets.

      Work directly on the canvas to select each of the placeholder headings (including the brackets) and replace them with actual headings (for example, Update your contact information and Newsletter subscriptions).


      Many of the supplied templates for emails, pages, and forms employ this convention of using square brackets to mark instructional placeholder text. They also typically use pseudo-Latin ("lorem ipsum") text as a placeholder for body text, and sometimes example text for headlines, but these don't use square brackets because the text isn't instructional.

  6. On the Toolbox tab, scroll down until you find the Subscription Lists heading. You should see the subscription list that you just made listed here, plus any others that were already in your system. Drag it from the Toolbox to the space under the Newsletter subscriptions heading.
    Add a subscription list to the form


    Only forms of type Subscription Center show subscription lists in the Toolbox.

  7. On the command bar, select Save to save your new form.

Create a subscription center marketing page

Go to Marketing > Internet Marketing > Marketing Pages and create a subscription center page by using the same basic procedure that you used to create a landing page, but be sure to do the following:

  1. Make sure the page Type is Subscription Center, or choose a marketing page template where Type is Subscription Center.

  2. Include a Form block that references the subscription form you just made.

  3. Enter values for all other required fields (Name and Partial URL).

  4. Select Check for Errors and address any issues reported.

  5. Select Go Live.

For a detailed walkthrough of how to create a marketing page, see Create a landing page with a form.

Identify a subscription center in content settings

As you saw in Create a marketing email and go live, content settings hold common values that you can place into an email message as dynamic text by using assist-edit (or by typing the correct code). You can create as many Content Settings records as you need, and you must assign one to each customer journey. Because of this architecture, you can use the same email message in several customer journeys, but the subscription center link (and other content settings) included in the message can be different for each journey.

To work with content settings records, go to Marketing > Templates > Content Settings. This brings you to a list of current content settings. As usual, you can edit any listed record or select New on the command bar to create a new one.


Like email messages and customer journeys, content settings must be published to the Dynamics 365 email marketing service (by choosing Go Live). After a Content Settings record is published, you can't edit its values. If you need to edit a live Content Settings record, choose Stop from the toolbar after opening the record, and then make your changes. Remember to Go Live again when you are done editing.

Each field shown here (besides the Name and Default setting) can be referenced dynamically in your email messages. The two fields, Address Main and Subscription Center must be referenced in all marketing emails, so they are likewise required here.

Content-settings settings

To specify a subscription center:

  1. Select the Subscription Center field.

  2. Select the assist-edit button </> for the Subscription Center field.

  3. A drop-down list opens. Select Marketing Page. This identifies the type of entity you are referencing.
    Choose the Marketing Page entity

  4. Assist-edit adds some code and then opens a new drop-down list that shows each marketing page available in your system. Select the name of the subscription page you want to reference.
    Choose a specific marketing page

  5. Assist-edit adds the GUID (a unique ID code) for the page you selected, and then opens a third drop-down list that shows the names of several relevant attributes from the Marketing Page entity. We are looking for the page URL, so choose FullPageUrl.
    Choose the field value to find with the expression


    The expression you just created by using assist-edit is of the form:


    This expression evaluates to the value of the named attribute (in this case, the URL of a marketing page) from a record of the named entity and ID.

    Using similar techniques, you can also reference a Forward to a Friend page and you can even construct Address Main by grabbing field values from an account record.

  6. Make other content settings as needed. When you are done, Save, Check for Errors, and then Go Live.

Identify the content settings to use in a customer journey

As mentioned, content settings are defined on the customer journey level, and apply to all email messages sent by that journey. To view and edit the content settings applied to a journey:

  1. Go to Marketing > Marketing Execution > Customer Journeys.

  2. Find your journey in the list, or select New in the command bar to create a new one.

  3. Go to the General page of the customer journey record.
    Where to set content settings for a journey

  4. Use the Content Settings field to choose the Content Setting record that applies to the current journey.

To add a subscription center link to a marketing email:

  1. While working in a text block, add some link text (such as manage subscriptions) at an appropriate place.

  2. Select the anchor text, and then select the Link button The link button from the floating toolbar, which opens the Link dialog box.

  3. Select the assist-edit button for the Link field, and then choose msdyncrm_contentsettings from the first drop-down list and msdyncrm_subscriptioncenter from the second one to build the expression: {{msdyncrm_contentsettings.msdyncrm_subscriptioncenter}}.
    The email Link dialog

  4. Select OK to create the link.

More information: Create a marketing email and go live

Create a segment based on a subscription list

After you've set up a subscription list, you'll probably want to send regular email messages to your subscribers. To do this, you need to set up a marketing segment that finds all the contacts on a subscription list, and then use that segment as the first tile in a customer journey that automates your email deliveries and other initiatives.

To set up a segment based on a subscription list:

  1. Go to Marketing > Customers > Segments and select New on the command bar.

  2. The New Segment page opens, with the General tab shown. Fill out the information on the General tab to name and describe your new segment. Be sure to leave the Segment type set to Dynamic segment.
    The General tab for the segment entity

  3. Open the Definition tab, and then go to the Designer sub tab.
    The Designer tab for the segment entity

  4. The new segment already has a default expression here, which is set to query the Contacts entity. But we need to start with the Marketing List entity instead, so remove the default expression by selecting its close button (X).
    Choose the close button to remove the default clause

  5. Now you have a blank expression with a single drop-down list marked Select a profile or relationship. Select Marketing List from this drop-down list, and then complete the expression so it will find your subscription list, for example: Marketing List | Name | is | Newsletter, which will find a marketing list by name. If more than one list has the same name, all lists with that name will be combined by this segment, so be careful.
    Select a profile or relationship

  6. Now you've identified a list, but the segment needs to find contacts, so you need to combine the identified list with an expression that finds the contacts referenced by that list. Select the +And button under your new expression to add another clause.
    Add a new AND clause

  7. A new clause is added to your expression by using an AND operator. Set the new clause to find all the contacts in your list by setting it to And | Contact | All*.
    The final subscription-list segment definition

  8. Save your work.

  9. Your segment now includes all contacts from the specified marketing list. If you want, you can add more clauses and groups to narrow or expand the segment.

See also

Market segmentation, marketing lists, and subscription lists
Create a segment
Find your way around
How Dynamics 365 for Marketing uses cookies