.avif)
Overview
Here, you will find a comprehensive guide to diagnose and resolve Dynamics 365 App for Outlook issues. This covers the App for Outlook, not the retired COM-based Dynamics 365 for Outlook add-in. The steps are current to Microsoft's published support matrix. Work them top to bottom, and most issues clear before the escalation section.
Permissions Settings
Ensure that the users have the following security role: Dynamics 365 App for Outlook User.
This role ships out of the box with your environment. Assign it to anyone who should use the App for Outlook. A missing role is the single most common reason a user does not appear in the All Eligible Users list when an admin tries to push the app.
Email Server
Make sure that your email service is supported. The App for Outlook tracks and synchronizes mail and calendar data through server-side synchronization, so your mailbox has to live on a supported Exchange platform. Here is the current list.
A word on older servers. Microsoft's matrix still lists Exchange Server 2013 CU14 as a floor, but Exchange Server 2013 reached end of support on April 11, 2023. It receives no security updates. Treat it as off the table and plan a move to Exchange Online or Exchange Server 2019.
Email Client
Alongside the email server, make sure that your Outlook version is supported. Microsoft retired the old "Outlook 2013/2016 with these exact build numbers and Internet Explorer 11 installed" list. Here is the current rule.
The headline change: the App for Outlook is not supported on any Outlook version that uses Internet Explorer or Legacy Edge WebView. Microsoft blocked Internet Explorer for the app on October 31, 2022, following the end of support for Internet Explorer and Microsoft Edge Legacy. If a user still loads the app through an IE-backed Outlook, it will not work, and no troubleshooting step fixes that. The fix is to upgrade the client.
For the desktop, move users to an Outlook version that uses Edge WebView2, or use Outlook on the web. The new Outlook for Windows is built on WebView2 and modeled on Outlook on the web. Classic Outlook, whether from Microsoft 365 or a perpetual license, remains supported, so you do not have to rush a migration. You do have to leave Internet Explorer behind.
One feature did retire. Contact tracking from the classic Outlook desktop app reached end of support on October 1, 2025. That capability let users track Outlook contacts directly into Dynamics 365 Sales from classic Outlook. If a user reports that contact tracking stopped working, it was deprecated, not broken. Track contacts from inside the Dynamics 365 app instead.
Browser (Outlook Web Access)
When users run the app through Outlook on the web, three browsers are supported by Dynamics 365 App for Outlook.
Supported Clients per Feature
“The Dynamics 365 App for Outlook features supported depend on the client you're running. The following table summarizes which features are supported for each client/configuration of Customer Engagement and Exchange.”
Supported Languages
Here is the list of languages that the Dynamics 365 App currently supports for Outlook.
Clear Your Browser Cache
A stale cache is a frequent cause of a white screen or an app that loads the wrong state. Here is how to clear your browser cache and cookies.
Check Your Anti-Virus
This step gets overlooked. Some antivirus and endpoint-protection tools block connections to Dynamics 365 or Microsoft 365 endpoints.
As a controlled test, temporarily disable the security product on the affected machine and retest. If the app works, add the required Microsoft endpoints to the allowlist, then re-enable protection. Never leave protection off.
Other Specific Issues
After the basic diagnostic steps, the issues below cover most support tickets. Microsoft retired its old per-issue knowledge-base articles for these symptoms, so treat the descriptions as your diagnostic map and use the live troubleshooting hub for current fixes. Microsoft maintains a current Dynamics 365 App for Outlook troubleshooting hub with up-to-date, symptom-specific articles.
Deploying or Opening the App
A user does not appear in the All Eligible Users list. Almost always a missing Dynamics 365 App for Outlook User role, or a mailbox that is not on a supported Exchange platform.
The app deployed but does not appear in Outlook. Confirm the client uses Edge WebView2, not Internet Explorer or Legacy Edge WebView. Then clear the cache and restart.
A white screen on open. Usually a WebView or cache problem. Clear the cache, confirm the WebView2 runtime, and retest. An error on open: capture the exact message, since a privilege error such as the read-organization privilege points at security roles.
Tracking Email or Appointments
No results in the Regarding lookup. Confirm the user has read access to the target table and that the records exist in their business unit.
An item stays in "Track Pending." This is expected for compose-mode email and recurring appointments. Wait one sync cycle, up to 15 minutes, before you escalate it.
Track and Set Regarding are missing or disabled. This is a privileges problem, not a missing app. Review the user's security roles.
Tracking Contacts
One feature did retire. Contact tracking from the classic Outlook desktop app reached end of support on October 1, 2025. That capability let users track Outlook contacts directly into Dynamics 365 Sales from classic Outlook. If a user reports that contact tracking stopped working, it was deprecated, not broken. Track contacts from inside the Dynamics 365 app instead.
Last Resort
You have confirmed the role, the server, the client, and the browser, cleared the cache, ruled out antivirus, and waited out a sync cycle. The issue persists. Now open a case with Microsoft.
We wrote a step-by-step walkthrough on how to open a Microsoft support ticket for Dynamics 365 and Power Platform so you reach the right queue with the right diagnostic detail attached. If you would rather hand it off, contact us.
Call Us
Still stuck after the full checklist? We deploy and stabilize the App for Outlook for Dynamics 365 Sales and Customer Service teams: roles assigned, server-side sync configured, clients standardized on supported, WebView2-based Outlook.
Contact us to speak with one of our Dynamics 365 specialists and get your team tracking from the inbox again.
Sources: Microsoft Learn, System requirements for Dynamics 365 App for Outlook and Troubleshoot Dynamics 365 App for Outlook.
