Test Office Add-ins
This article contains guidance about testing, debugging, and troubleshooting issues with Office Add-ins.
Test cross-platform and for multiple versions of Office
Office Add-ins run across major platforms, so you need to test an add-in in all the platforms where your users might be running Office. This usually includes Office on the web, Office on Windows (both perpetual and Microsoft 365 subscription), Office on Mac, Office on iOS, and (for Outlook add-ins) Office on Android. However, there may be some situations in which you can be sure that none of your users will be working on some platforms. For example, if you are making an add-in for a company that requires its users to work with Windows computers and subscription Office, then you don't need to test for Office on Mac or perpetual Office on Windows.
Note
On Windows computers, the version of Windows and Office will determine which browser control is used by add-ins. For more information, see Browsers used by Office Add-ins.
Important
Add-ins marketed through AppSource go through a validation process that includes testing on all platforms. In addition, add-ins are tested for Office on the web with all major modern browsers, including Microsoft Edge (Chromium-based WebView2), Chrome, and Safari. Accordingly, you should test on these platforms and browsers before you submit to AppSource. For more information about validation, see Commercial marketplace certification policies, especially section 1120.3, and the Office Add-in application and availability page.
AppSource does not use Internet Explorer or the legacy version of Microsoft Edge (WebView1) to test add-ins in Office on the web. But if a significant number of your users will use legacy Edge to open Office on the web, then you should test with it. (Office on the web will not open in Internet Explorer, so you cannot, and do not need to, test Office on the web with Internet Explorer.) For more information, see Support Internet Explorer 11 and Troubleshooting Microsoft Edge issues. Office still supports these browsers for add-in runtimes, so if you think you've encountered a bug in how add-ins run in them, please create an issue for the office-js repo.
Sideload an Office Add-in for testing
You can use sideloading to install an Office Add-in for testing without having to first put it in an add-in catalog. The procedure for sideloading an add-in varies by platform, and in some cases, by product as well. The following articles each describe how to sideload Office Add-ins on a specific platform or within a specific product.
Unit testing
For information about how to add unit tests to your add-in project, see Unit testing in Office Add-ins.
Debug an Office Add-in
The procedure for debugging an Office Add-in varies based on your platform and environment. For more information, see Debug Office Add-ins.
Validate an Office Add-in manifest
For information about how to validate the manifest file that describes your Office Add-in and troubleshoot issues with the manifest file, see Validate and troubleshoot issues with your manifest.
Troubleshoot user errors
For information about how to resolve common issues that users may encounter with your Office Add-in, see Troubleshoot user errors with Office Add-ins.
Feedback
Submit and view feedback for