How to Deploy a React Word Add-In to Start Automatically
Question details
The user needs a React-based Word add-in to start automatically for end-users in a production environment without requiring manual activation.

- Product
- Microsoft Word
- Device & OS
- not provided
- Scenario
- Deploying a custom React-based add-in to a production environment where it needs to initialize automatically for users.
- Observed behavior
- The add-in successfully runs and starts automatically in debug mode via manifest and registry changes, but requires users to manually activate it in production environments.
Ensure your React add-in is fully packaged, signed with a trusted certificate, and that you have administrator access to your target deployment environment (such as the Microsoft 365 Admin Center).
Use Microsoft 365 Centralized Deployment
The most secure and Microsoft-supported method for organizations using Microsoft 365 to deploy add-ins automatically to users.
Office add-ins do not generally support unrestricted automatic activation through local registry edits alone due to security restrictions. Centralized deployment manages these permissions at the organizational level.
Ensure your React Word add-in is appropriately packaged and signed for production release, and hosted on a secure HTTPS server.
Log in to the Microsoft 365 Admin Center using an administrator account.
Navigate to Settings > Integrated apps and choose to upload your custom manifest file for the add-in.
Assign the add-in to specific users, groups, or the entire organization. Once propagated, the add-in will automatically deploy and activate for the targeted users.

Deploy via Trusted Network Share or MSI
The recommended approach when cloud-based deployment is not allowed by organizational security policies.
Try WPS Office for a Streamlined Document Experience
Developing and deploying custom add-ins for Microsoft 365 can be complex and requires managing strict organizational policies. If you are looking for a highly compatible, lightweight, and free alternative to Microsoft Office, WPS Office offers an intuitive interface and excellent format support.
- 1. Download WPS Office: Visit the official WPS Office website and download the free installation package for your operating system.
- 2. Install the Software: Run the installer and follow the on-screen prompts to complete the lightweight installation process.
- 3. Open Your Documents: Launch WPS Writer and open your existing .docx files directly without needing complex configurations or cloud deployments.

Frequently Asked Questions
Can I use only registry edits to make an Office add-in start automatically?
No. Office add-ins generally do not support unrestricted automatic activation strictly through registry edits due to built-in security constraints. A supported deployment method like Centralized Deployment is required.
Why does my React add-in start automatically in debug mode but not in production?
Debug mode bypasses several security and deployment policies for developer convenience. In a production environment, add-ins require proper packaging, signing, and organizational deployment policies to trigger automatic activation.
What is required to use Microsoft 365 Centralized Deployment?
You need an active Microsoft 365 subscription, administrator privileges in the Microsoft 365 Admin Center, and your add-in must be properly manifested and hosted on a secure (HTTPS) web server.
How do I deploy my add-in if my organization blocks cloud deployments?
You can use an on-premises deployment method, such as a trusted network share deployed via Group Policy, or package your add-in using an MSI installer that configures the necessary trusted locations on local machines.




