Known issues and workarounds

This document provides important, late-breaking information about known issues and workarounds for Dynamics 365 Marketing. For information about monthly bug fixes, visit the What's new in Dynamics 365 Marketing article.

Configuration, installation, and first-run experience

  • The setup process can take up to two hours. The process might restart automatically during this time, which can result in multiple success (or failure) notifications being sent to you by email.
  • Although the licensing agreement doesn't require it, a known technical issue currently prevents you from running the setup wizard unless you have a Dynamics 365 license with the System Administrator security role assigned on your target Dynamics 365 instance.
  • Some language strings in the email designer and customer journey designer are not available in all languages.
  • When an entitlement is changed, the updated working entitlement will sometimes display as "NotConfigured" and the broken entitlement will display as "Configured" in the Admin UI. You may get this fixed by raising a support request.
  • When a portal is expired, the Configure your portal item under Other actions links to the old portal.
  • When a setting from the Marketing application settings overview page is selected, users who do not have admin privileges to adjust the setting are redirected to a blank page.

Customer journeys

  • Deactivated contacts won't receive any emails from journeys they may be participating in, but they might continue to be included in other actions, such as tasks and workflows.
  • Insights for journeys, emails, and marketing pages may take up to six hours to display.
  • The date scheduler tile in customer journeys doesn't display dates according to the Japanese imperial calendar (including in Japanese localizations).
  • Export to Excel functionality is limited to 10,000 records.

Designer feature protection

  • Designer feature protection enables admins to limit access to the HTML tab and/or Litmus previews for content designers. However, the protection only applies to users who have read access to the Designer Feature Access entity. Users without this read access will always be able to see the HTML and Litmus features, even if you use designer feature protection to block them. To solve this, make sure all security roles provide read access to the Designer Feature Access entity. If you are using the out-of-box security roles supplied with the product, then these should automatically update to include this access when you apply the October 2018 (or later) update, but if you use custom security roles you need to add this access explicitly after updating. More information: Security roles and privileges.

Event management

  • If you disable anonymous registration for the event portal, then customer organizations must create a registerer account using the portal, after which the registerer can register as many attendees from their organization as needed. However, the registerer can't use the portal to create an account using an email address that belongs to a contact already in Dynamics 365. To set up an existing contact as a registerer, create a portal invitation and then send the invitation code to the contact by email.


  • The following features from the April 2019 release require that your instance has access to the latest Dynamics 365 infrastructure and services: manage segment memberships from the contact record, session-level event registration, event-registration QR codes in email, portal-optional operation, and some segmentation improvements. We are rolling out the needed infrastructure updates as quickly as possible, and most customers should have them already. If you are running the April 2019 release and require one or more of these features but don't have them available on your instance, contact Microsoft Support to get your infrastructure updated right away.
  • If you have different Dynamics 365 sessions open in other browser windows or tabs, and then open the Marketing app in the same browser, it will authenticate using the same user that you have open in the other sessions. We recommend that you restart the browser each time you need to sign in using a different Dynamics 365 user account.
  • Avoid deactivating publishable (go-live) records. Instead, change the publishing state (Status reason), and use the Stop buttons to manage records that are no longer required. More information: Go live with publishable entities and track their status.
  • Dynamics 365 Marketing is currently supported only on the following browsers: Microsoft Edge, Google Chrome, and Apple Safari on Mac. More information: Browser and system requirements.
  • Right-to-left (RTL) language support currently has the following limitations: the segmentation designer is usable, but shows its user-interface elements in the wrong order; and the supplied content samples (marketing-page templates, email templates, form templates, and event website) aren't provided in RTL layouts.


  • Web interactions registered for an anonymous visitor (on a tracked website, marketing page, marketing form, or redirect URL) don't currently become attributed to a contact record if those visitors later become known contacts. Though these interactions remain anonymous, you can still see them under the related entity (marketing page, website, etc.) and they are leveraged to compute the insights for each record. More information: Websites
  • Customer journey insights include a count of contacts that stopped their journey midway because the "Contact joined the suppression segment." In the current release, this count may be unreliable. The suppression segment still works, and the contacts will be stopped correctly on joining it, but some of the contact numbers won't add up due to stopped contacts not getting counted here.
  • Email insights include a map showing where recipients were when they opened your message. For Gmail addresses, this information will often be inaccurate because of the way that Gmail caches embedded images. Geographical information can also be inaccurate for recipients using a VPN or a widely distributed corporate network.

Lead scoring and management

  • Lead scoring results might take up to one hour to be calculated.
  • When you're creating lead scoring rules, drop-down lists might not be localized for non-English languages.

Marketing emails

  • On some instances, emails that include date fields may fail the error check (with an "unsupported property type" error) and therefore can't go live. If you are affected by this issue, contact Microsoft Support and ask them to update your instance with the known fix.
  • The default content-settings record must be live before you can send any marketing emails or view heatmaps on Insights pages. Usually, the default content-settings record goes live automatically when your setup is complete, but sometimes this isn't the case. To solve this, set up and publish your default content-settings record manually as described in Use content settings to set up repositories of standard and required values.
  • Selecting Stop on a live email will prevent it from being used in future journeys, but it will continue to function in existing live journeys, which will continue to deliver it.
  • If you reuse the same email multiple times (within the same journey or in different journeys), you will see incorrect performance results on its Insights pages.
  • Many email templates have placeholder images. You should replace these placeholder images with actual images so that marketing emails look professional.
  • The email designer requires care when entering code for advanced dynamic content. It's easy to produce non-working code. If you want to use this feature, be sure to review the notes given in How to enter code in the designer.
  • If you create an email message with dynamic content that attempts to fetch a single value through a one-to-many database relation, then the system won't know which related record to fetch. As a result, the message will end in an error state when published to the sending service and will therefore never get sent (the error checking mechanism currently doesn't catch this error, which is why you can still publish it). An example of a one-to-many relation is the one between contacts and event registrations because each contact can register for multiple events. To prevent this error from occurring, use a for-each loop to enclose any expressions that reference a one-to-many relationship (this will loop through each related record). More information: Add dynamic content to email messages.
  • Column padding does not always function correctly in new page templates.
  • Dotted column border styles do not render properly for one column layouts in the email designer.
  • Subscription lists are managed at the contact level. If multiple contacts share the same email address, only the specific contact who opted out will stop receiving communications. Other contacts using the same email address will continue to receive communications. If you require opt-outs to be processed at the email level, you will need to create custom processes. More information: Manage subscriptions at an email level.
  • As of March 2021, A/B testing is not yet available in the new email designer.
  • If you have any email editor customizations, your administrator will need to manually recreate them in the new email designer.

Marketing pages and forms

  • It's possible for contacts using browsers that don't respect HTML5 form validation (notably iOS devices) to submit marketing forms that don't include values for all required fields.
  • When using form capture, data model changes to mapped fields do not reflect in Dynamics 365 Marketing until you manually refresh the Marketing form capture page after making the change.
  • Previews for marketing pages with a single column section larger than 1000 px include a horizontal scrollbar by default.
  • The form capture tool may not be able to capture all non-Latin script characters correctly. Unrecognized characters are replaced by HTML codes.
  • Date field values are not show in the Insights tab under Submissions for forms.

Reusable content blocks

  • Any CSS styles that you include in your reusable content blocks could be overruled by styles in the document where you eventually host the content. If you want to prevent this, design your content blocks with inline styles that include the !important attribute.


  • Metadata used for building conditions and drop-downs shown on the designer isn't localized for non-English organizations.
  • When trying to estimate the size of a segment where the query doesn't end in a contact, the system displays a server communication error. To correct this error, make sure your segment definition ends with a clause that links to the contact entity as described in Design dynamic demographic or firmographic segments.
  • Segments that are created, activated, and exported from Customer Insights, then published in Marketing will not always display the segment members in Marketing.
  • If you create a new static segment and then refresh the page before saving the segment at least once, it will revert to a dynamic segment and you'll need to start over to create a new static one.
  • In the Members view, you can sort by "Full name" and "Email" columns. Sorting by related entities or custom columns or views is not supported.

Social posting

  • When opening an existing social post, the old UI momentarily displays.


  • Trials are subject to the Dynamics 365 Marketing trial limits and restrictions.
  • You can't use the sign-up process to add more users to a Marketing trial that is running on a trial tenant without a mailbox set up for the organization admin. Instead, each new user must be added in a specific way. For more information, see Add more users to a Marketing trial running on a trial tenant.
  • You can't sign up using an email address. If you are a Microsoft employee and would like to sign up for a trial, start by setting up a Microsoft 365 E3 trial, which will provide you both with a trial tenant (where you can install the Marketing trial) and a new email address that you can use to sign up for the Marketing trial. More information: Sign up for a free trial.


  • When you add a video to a marketing page, the Designer tab shows it as a thumbnail image rather than as an embedded video in an iframe. However, the embedded video iframe will still be shown correctly on the live page when you publish it.


  • The websites feature records all visits to any web page that has a Dynamics 365 Marketing tracking script on it. Each log entry includes a timestamp and, if possible, links to a known contact. If the visitor isn't a known contact, then that visit is logged as anonymous. The website tracking script sets a cookie, so the system can group visits into sessions, even for anonymous visits. When a contact submits a landing-page form, the system sets the same cookie (if not present already) and can thereafter match the cookie ID to a contact ID because the landing-page submission will either create or match a contact. Once a visitor is known, all future website visits will be logged with that user's ID. However, previous visits will remain anonymous (the system doesn't back-fill the contact ID to the existing visitor log).


Can you tell us about your documentation language preferences? Take a short survey.

The survey will take about seven minutes. No personal data is collected (privacy statement).