How to Sideload an Office.js Add-In into Excel
Question details
The user needs to know how to install or sideload a custom Office.js add-in manifest file into Microsoft Excel for testing or shared deployment.

- Product
- Microsoft Excel
- Device & OS
- not provided
- Scenario
- Testing a custom add-in locally or deploying it via a network shared folder without publishing it to the official Office Store.
- Observed behavior
- The user is looking for the specific interface menus (like My Add-ins or Trust Center) to upload the manifest file and successfully load the add-in into the Excel ribbon.
Ensure you have your valid Office.js add-in manifest (.xml) file ready and accessible on your local drive or hosted in a configured network shared folder.
Sideload Add-in via 'My Add-ins' Direct Upload
Use this method to quickly upload an individual manifest file directly into your current Excel session for local testing.
This is the fastest method for testing a newly developed Office.js add-in on your local machine.
Open Microsoft Excel, click on the 'Insert' tab in the top ribbon, and select 'Get Add-ins'.
In the Office Add-ins dialog box, switch to the 'My Add-ins' tab.
Click the 'Upload My Add-in' option (or select 'Add a Custom Add-in' > 'Add from File') and browse your computer to select your custom manifest.xml file.
Sideload Add-in using a Trusted Shared Folder
Ideal for development teams or distributing custom add-ins to multiple users via a local network share.
Need a Fast, Compatible Office Suite for Your Work?
While sideloading Office.js add-ins is a feature specific to Microsoft 365 ecosystems, you might be looking for a reliable, lightweight suite for your everyday spreadsheet tasks. WPS Office provides a powerful, free alternative that perfectly handles complex data, charts, and standard plugins.
- 1. Download the Installer: Visit the official WPS Office website and click the 'Download WPS Office Free' button.
- 2. Install the Software: Run the downloaded executable file and follow the brief on-screen instructions.
- 3. Open WPS Spreadsheet: Launch WPS Spreadsheet to instantly open, edit, and save your Excel documents with full formatting retention.

Frequently Asked Questions
Why is the 'Upload My Add-in' option missing in Excel?
This option may be hidden based on your specific Microsoft 365 build or explicitly disabled by your organization's IT administrator for security reasons. Check under 'Manage My Add-ins' or consult your IT department to enable custom sideloading.
Can I sideload an Office.js add-in on Excel for Mac?
Yes, on Excel for Mac you can sideload add-ins by placing the manifest.xml file into a specific local system folder (typically located within the Library/Containers directory for Microsoft Excel) and restarting the application.
Does the shared folder method keep the add-in permanently installed?
The shared folder method keeps the catalog available across all your Excel sessions. However, if the network path or folder becomes temporarily unavailable or disconnected, Excel will not be able to load the add-in until access is restored.
What is the correct format for an Office.js add-in manifest?
The manifest must be a properly structured XML file that adheres to the official Microsoft Office Add-ins XML schema. It defines critical metadata such as the add-in's ID, version, capabilities, ribbon buttons, and the source URL of the web application.




