Browsers used by Office Add-ins
Which browser is used depends on:
- The computer's operating system.
- Whether the add-in is running in Office on the web, Microsoft 365, or non-subscription Office 2013 or later.
Internet Explorer still used in Office Add-ins
Microsoft is ending support for Internet Explorer, but this doesn't significantly affect Office Add-ins. Some combinations of platforms and Office versions, including all one-time-purchase versions through Office 2019, will continue to use the webview control that comes with Internet Explorer 11 to host add-ins, as explained in this article. Moreover, support for these combinations, and hence for Internet Explorer, is still required for add-ins submitted to AppSource. Two things are changing:
- AppSource no longer tests add-ins in Office on the web using Internet Explorer as the browser. But AppSource still tests for combinations of platform and Office desktop versions that use Internet Explorer.
- The Script Lab tool will stop working in Internet Explorer sometime in 2021.
The following table shows which browser is used for the various platforms and operating systems.
|OS||Office version||Edge WebView2 (Chromium-based) installed?||Browser|
|any||Office on the web||Not applicable||The browser in which Office is opened.|
|Windows 7, 8.1, 10||non-subscription Office 2013 or later||Doesn't matter||Internet Explorer 11|
|Windows 7||Microsoft 365||Doesn't matter||Internet Explorer 11|
Windows 10 ver. < 1903
|Microsoft 365||No||Internet Explorer 11|
|Windows 10 ver. >= 1903||Microsoft 365 ver. < 16.0.116291||Doesn't matter||Internet Explorer 11|
|Windows 10 ver. >= 1903||Microsoft 365 ver. >= 16.0.11629 AND < 16.0.13530.204241||Doesn't matter||Microsoft Edge2, 3 with original WebView (EdgeHTML)|
|Windows 10 ver. >= 1903||Microsoft 365 ver. >= 16.0.13530.204241||No||Microsoft Edge2, 3 with original WebView (EdgeHTML)|
|Microsoft 365 ver. >= 16.0.13530.204241||Yes4||Microsoft Edge2 with WebView2 (Chromium-based)|
1 See the update history page and how to find your Office client version and update channel for more details.
2 When Microsoft Edge is being used, the Windows 10 Narrator (sometimes called a "screen reader") reads the
<title> tag in the page that opens in the task pane. When Internet Explorer 11 is being used, the Narrator reads the title bar of the task pane, which comes from the
<DisplayName> value in the add-in's manifest.
3 If your add-in includes the
<Runtimes> element in the manifest, then it will not use Microsoft Edge with the original WebView (EdgeHTML). If the conditions for using Microsoft Edge with WebView2 (Chromium-based) are met, then the add-in uses that browser. Otherwise, it uses Internet Explorer 11 regardless of the Windows or Microsoft 365 version. For more information, see Runtimes.
4 The embeddable WebView2 control must be installed so that Office can embed it, and it is not installed with Edge automatically. It is installed with Microsoft 365, version 2101 or later. If you have an earlier version of Microsoft 365, use the instructions for installing the control at Microsoft Edge WebView2 / Embed web content ... with Microsoft Edge WebView2.
For more information about these options, see Support Internet Explorer 11.
Also, Internet Explorer 11 does not support some HTML5 features such as media, recording, and location.
Troubleshooting Microsoft Edge issues
Service Workers are not working
Scroll bar does not appear in task pane
By default, scroll bars in Microsoft Edge are hidden until hovered over. To ensure that the scroll bar is always visible, the CSS styling that applies to the
<body> element of the pages in the task pane should include the -ms-overflow-style property and it should be set to
When debugging with the Microsoft Edge DevTools, the add-in crashes or reloads
Setting breakpoints in the Microsoft Edge DevTools can cause Office to think that the add-in is hung. It will automatically reload the add-in when this happens. To prevent this, add the following Registry key and value to the development computer:
When the add-in tries to open, get "ADD-IN ERROR We can't open this add-in from the localhost" error
One known cause is that Microsoft Edge requires that localhost be given a loopback exemption on the development computer. Follow the instructions at Cannot open add-in from localhost.
Get errors trying to download a PDF file
Directly downloading blobs as PDF files in an add-in is not supported when Edge is the browser. The workaround is to create a simple web application that downloads blobs as PDF files. In your add-in, call the
Office.context.ui.openBrowserWindow(url) method and pass the URL of the web application. This will open the web application in a browser window outside of Office.