Troubleshooting errors when attempting to open Microsoft Dynamics 365 App for Outlook
This article provides a solution to errors that occur when using Dynamics 365 App for Outlook.
Applies to: Microsoft Dynamics 365
Original KB number: 4345548
When attempting to open Dynamics 365 App for Outlook, you receive an error message.
Use the Help me resolve this issue link
Most errors you may meet will include a Help me resolve this issue link. If it appears, make sure to select this link. If Microsoft is aware of a potential solution to the issue, this link will direct you to an article created to help solve that specific error.
Clear your browser cache
If you're using Office 365 version 16.0.11629 and Windows 10 version 1903 or later, follow these steps as Office Add-ins are now using Microsoft Edge WebView:
- Install Microsoft Edge DevTools Preview.
- In Outlook, launch the Dynamics 365 app for Outlook.
- Run Microsoft Edge DevTools Preview.
- You should see Dynamics 365 (EXP) as a debug target.
- Select it to launch the F12 tools.
- Go to the Console tab.
- Run: window.localStorage.clear().
- Open the app again in Outlook.
If you're using early versions of Office 365 and Windows, use the following steps:
|Outlook (same as Internet Explorer)||View and delete your browsing history in Internet Explorer|
|Internet Explorer||View and delete your browsing history in Internet Explorer|
|Edge||View and delete browser history in Microsoft Edge|
|Chrome||Clear cache & cookies|
Although you may have other browsers installed on your computer, Outlook desktop always uses Internet Explorer when displaying web content such as inside Dynamics 365 App for Outlook. As mentioned in the beginning of this section, it's no longer true starting with Office 365 version 16.0.11629.
After clearing your browser cache, close all Internet Explorer and Outlook desktop windows and make sure through Task Manager there are no remaining Internet Explorer processes running.
If this issue only appears in Outlook desktop and clearing the cache via Internet Options doesn't help, try clearing it via F12 chooser (not applicable for Windows 7):
- Open Dynamics app in Outlook desktop.
- Open IEChooser.exe in
- Select Dynamics 365.
- Select the Network tab and then select the Clear cache button.
After following the steps above, reopen Outlook and the Dynamics 365 App for Outlook to see if the issue is resolved.
If you're using a Mac, see Clearing the Office application's cache on a Mac.
Other Known Issues
Opening a support case
If you're unable to resolve the issue and need help from Microsoft, include the following information to help solve your case as fast as possible:
Provide detailed steps that result in the error.
Include the details of any error message that appears. If the error includes a Show more option, copy and paste these details into the case.
Include information such as the version of the following components:
- Outlook (ex. Office 2013 SP3)
- Microsoft Exchange (ex. Exchange 2013 CU15 or Exchange Online)
- Operating System (ex. Windows 10)
Indicate if the issue occurs for all users, or only certain users such as only users with a certain security role or only users with a certain version of Outlook.
Third-party information disclaimer
The third-party products that this article discusses are manufactured by companies that are independent of Microsoft. Microsoft makes no warranty, implied or otherwise, about the performance or reliability of these products.