How to Deploy VSTO Add-Ins in Azure Virtual Desktop
Question details
The user needs to deploy VSTO add-ins for Office applications within an Azure Virtual Desktop environment without using separate shortcut launches.

- Product
- Microsoft Office (Word, Excel, PowerPoint)
- Device & OS
- Azure Virtual Desktop (Windows)
- Scenario
- Configuring enterprise-level Office add-ins to load seamlessly within installed Office applications across virtual desktop session hosts.
- Observed behavior
- The add-ins must be configured to automatically load directly inside Word, Excel, or PowerPoint for all virtual desktop users instead of launching through separate shortcuts.
Ensure you have administrative access to your Azure Virtual Desktop session hosts and that your VSTO add-in deployment package (MSI or ClickOnce) is ready.
Consult Microsoft Q&A for Specialized Deployment Guidance
Because Azure Virtual Desktop deployment involves complex user-scope and virtual environment configurations, Microsoft recommends seeking targeted guidance from their engineering teams.
Deploying VSTO add-ins in virtualized environments like AVD often requires specific configurations tailored to your tenant, user profiles, and Office installation type (e.g., Shared Computer Activation). The Microsoft Office Development and AVD engineering teams provide direct support for these complex deployments.
Navigate to the official Microsoft Q&A website (learn.microsoft.com/en-us/answers/questions/) using your web browser.
Gather necessary information including your VSTO add-in behavior, Office installation type, deployment package format (MSI vs. ClickOnce), user scope, and AVD host configuration.
Click on 'Ask a question' and detail how you want the add-in to load within the installed Office applications rather than via separate shortcuts.
Tag your question with 'Azure Virtual Desktop' and 'Office Development' to ensure it reaches the appropriate Microsoft engineering teams for targeted assistance.

Deploy Using MSI and Group Policy (General Best Practice)
For virtual desktop environments like AVD, deploying VSTO add-ins via an MSI package and Group Policy is generally more reliable than per-user ClickOnce deployments.
Try WPS Office for a Lightweight and Compatible Experience
While deploying complex VSTO add-ins in virtualized environments can be challenging with Microsoft Office, WPS Office offers a streamlined, highly compatible alternative for everyday document editing, significantly reducing the overhead of virtual desktop resource management.
- 1. Visit the WPS Office Website: Go to the official WPS website to access the lightweight installer.
- 2. Download the Free Version: Click the download button to retrieve the installation package suitable for your environment.
- 3. Install and Deploy: Run the installer to deploy WPS Office quickly, providing an immediate, highly compatible office suite solution.

Frequently Asked Questions
Why doesn't my ClickOnce VSTO add-in load for all users in Azure Virtual Desktop?
ClickOnce deployments typically install to the local user profile (%localappdata%). In an Azure Virtual Desktop environment with roaming profiles or multiple session hosts, this prevents the add-in from loading for other users. Using an MSI installer at the machine level is the recommended approach for AVD.
What is the correct LoadBehavior registry value for VSTO add-ins?
Setting the LoadBehavior value to 3 ensures that the add-in loads automatically at startup. If the add-in encounters an error during launch, Office may automatically change this value to 2 (inactive) to prevent the application from crashing.
How do I enable VSTO logging to troubleshoot startup issues in AVD?
You can enable VSTO logging by adding a system environment variable named 'VSTO_SUPPRESSDISPLAYALERTS' and setting its value to '0', or by setting 'VSTO_LOGALERTS' to '1' to write detailed error messages to a local log file.
Can I run VSTO add-ins on non-Windows virtual environments?
No, VSTO (Visual Studio Tools for Office) relies heavily on the .NET Framework and COM architecture, which are strictly limited to Windows desktop environments.




