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

Symptoms

When attempting to open Dynamics 365 App for Outlook, you receive an error message.

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:

  1. Install Microsoft Edge DevTools Preview.
  2. In Outlook, launch the Dynamics 365 app for Outlook.
  3. Run Microsoft Edge DevTools Preview.
  4. You should see Dynamics 365 (EXP) as a debug target.
  5. Select it to launch the F12 tools.
  6. Go to the Console tab.
  7. Run: window.localStorage.clear().
  8. Open the app again in Outlook.

If you're using early versions of Office 365 and Windows, use the following steps:

Platform Instructions
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

Important

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):

  1. Open Dynamics app in Outlook desktop.
  2. Open IEChooser.exe in %WindowsFolder%\System32\F12(example: C:\Windows\System32\F12).
  3. Select Dynamics 365.
  4. 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

"The view is not available" error message appears when opening an email in the Dynamics 365 App for Outlook

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:

  1. Repro Steps
    Provide detailed steps that result in the error.

  2. Error Details
    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.

  3. Environment Details

    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)
  4. User Impact
    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.