'%3e%3cpath%20d='M8%200C12.4183%200%2016%203.58172%2016%208C16%2012.4183%2012.4183%2016%208%2016C3.58172%2016%200%2012.4183%200%208C0%203.58172%203.58172%200%208%200ZM11.6162%204.38379C11.2257%203.99337%2010.5927%203.99338%2010.2021%204.38379L8%206.58594L5.79785%204.38379C5.40732%203.99334%204.77429%203.99329%204.38379%204.38379C3.99331%204.77429%203.99335%205.40733%204.38379%205.79785L6.58594%208L4.38379%2010.2021C3.99348%2010.5927%203.99341%2011.2257%204.38379%2011.6162C4.77426%2012.0066%205.40734%2012.0065%205.79785%2011.6162L8%209.41406L10.2021%2011.6162C10.5927%2012.0066%2011.2257%2012.0067%2011.6162%2011.6162C12.0067%2011.2257%2012.0066%2010.5927%2011.6162%2010.2021L9.41406%208L11.6162%205.79785C12.0066%205.40735%2012.0066%204.77429%2011.6162%204.38379Z'%20fill='%23080E17'%20fill-opacity='0.46'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_3761_713'%3e%3crect%20width='16'%20height='16'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
Can Office Add-ins Run in Embedded Excel Online?
Question details
The user is looking to determine if Office JavaScript add-ins are supported and can execute properly within an Excel file that is embedded in a web application using Microsoft 365 and SharePoint.
- Product
- Excel Online, Microsoft 365, SharePoint
- Device & OS
- not provided
- Scenario
- Attempting to run custom or third-party Office JavaScript add-ins inside an Excel workbook that is embedded in a web application environment.
- Observed behavior
- Compatibility is unclear, or the user is encountering errors when loading the add-in in the embedded Excel environment without sufficient diagnostic details.
Before troubleshooting add-in compatibility issues, ensure you have access to your add-in's manifest file, exact error messages from the browser console, and details regarding your authentication setup.
Gather Required Diagnostic Information for the Add-in
To determine whether your specific Office JavaScript add-in can run in an embedded Excel Online instance, you must collect precise technical details about your environment.
Embedded Excel environments (such as SharePoint web parts or iframe embeddings) have strict security and origin policies. Identifying the exact configuration is crucial for diagnosing add-in failures.
Document exactly how the Excel file is being embedded into the web application. Common methods include using an iframe, SharePoint web parts, or the Microsoft Graph API.
Determine whether the host running the workbook is Excel Online via Microsoft 365, an on-premises SharePoint Server, or another host.
Examine the XML manifest file for your Office JavaScript add-in to ensure all necessary AppDomains are listed and the correct requirements for web hosts are specified.
Document how the web application handles authentication (e.g., SSO, OAuth) and capture screenshots or text of any exact error messages displayed in the browser's developer console.
Post in the Office Development Microsoft Q&A Forum
If you have collected the required information and the add-in still fails to run, escalate the issue to Microsoft's developer support community.
Try WPS Office for Seamless Spreadsheet Management
While developing custom JavaScript add-ins for embedded Microsoft Excel instances requires extensive troubleshooting and configuration, WPS Office offers a free, lightweight, and highly compatible alternative for everyday spreadsheet needs. It handles standard Excel files effortlessly without the complexity of web embeddings.
Frequently Asked Questions
What are Office JavaScript add-ins?
Office JavaScript add-ins are web applications built using standard web technologies (HTML, CSS, JavaScript) that interact with Microsoft Office documents to extend the functionality of applications like Excel, Word, and PowerPoint.
Can I run traditional VBA macros in embedded Excel Online?
No, Excel Online and its embedded versions do not support running VBA (Visual Basic for Applications) macros. You must use Office Scripts or Office JavaScript add-ins for web-based automation.
Why is my add-in failing to load in a SharePoint embedded Excel file?
Loading issues in embedded environments are frequently caused by cross-origin resource sharing (CORS) restrictions, iframe security policies, missing trusted domains in the manifest, or authentication token mismatches.
Does WPS Office support Microsoft Office JS add-ins?
WPS Office has its own customized developer ecosystem and supports standard VBA macros in its premium versions. However, specific Office JavaScript add-ins designed exclusively for the Microsoft 365 web environment will not directly run inside WPS Office.
