Can the Office Deployment Tool Install a Word XML Add-In?
Question details
The user wants to know if they can use the Office Deployment Tool (ODT) to integrate and install a Word add-in provided as an XML manifest across multiple tenant computers.

- Product
- Microsoft Word
- Device & OS
- not provided
- Scenario
- Deploying a custom Word XML add-in to all tenant computers within an organization using local administrator rights.
- Observed behavior
- The Office Deployment Tool successfully deploys Office but does not automatically process or install the XML add-in manifest, prompting the user to seek a compatible deployment method.
Ensure you have local administrator rights on the target tenant computers and access to either the Microsoft 365 admin center or your preferred endpoint management tool.
Deploy the XML Add-In via Microsoft 365 Admin Center
Instead of using the Office Deployment Tool, the most efficient way to deploy an XML add-in across tenant computers is through Centralized Deployment in the Admin Center.
The Office Deployment Tool (ODT) is designed to handle standard Office installation packages (like MSI or Click-to-Run files), not XML manifests. Centralized Deployment is Microsoft's recommended alternative for distributing custom XML add-ins to users within a tenant.
Sign in to the Microsoft 365 admin center using your global or Exchange administrator credentials.
Go to 'Settings' in the left-hand navigation pane, select 'Integrated apps', and then click on 'Add-ins'.
Click 'Deploy Add-in', choose to upload a custom app, select 'I have the manifest file (.xml) on this device', and browse for your XML file to upload it.
Select the specific users, groups, or the entire organization that should receive the add-in, and follow the remaining prompts to complete the deployment wizard.

Distribute the XML File Using a Management Script
If Centralized Deployment is not an option, you can deploy the XML manifest separately using a script or an endpoint management tool like Microsoft Intune.
Switch to WPS Office for Streamlined Document Management
If complex deployment tools, MSI installers, and manual XML add-in management in Microsoft Office are taking up too much IT time, consider WPS Office. It provides a lightweight, highly compatible alternative with built-in productivity features, reducing the need for deploying complex third-party add-ins.
- 1. Download the Installer: Visit the official WPS Office website and download the free, lightweight installer package.
- 2. Deploy Across Computers: Run the setup file to easily install the suite across your devices without needing complex deployment tools.
- 3. Open Your Documents: Launch WPS Office to instantly open, edit, and save your existing Word documents seamlessly.

Frequently Asked Questions
Why doesn't the Office Deployment Tool support XML add-ins directly?
The Office Deployment Tool (ODT) is explicitly engineered for downloading and configuring Microsoft 365 core application files, such as Click-to-Run or MSI packages. An XML manifest is not an installation package; it is a configuration file that directs Word to web-hosted add-in resources, thus requiring a different distribution mechanism like Centralized Deployment.
Can I test an XML add-in locally before deploying it to all tenant computers?
Yes. You can sideload the XML add-in for testing. Place the XML file in a local or shared folder, go to Word > File > Options > Trust Center > Trust Center Settings > Trusted Add-in Catalogs, add the folder path, and check 'Show in Menu'. You can then insert the add-in from the Shared Folder tab.
Do end-users need local administrator rights to receive centrally deployed XML add-ins?
No, if you deploy the add-in via the Microsoft 365 admin center (Centralized Deployment), end-users do not need local admin rights. The add-in is linked to their Microsoft 365 account and appears automatically. However, manually modifying local registries to trust a catalog folder does require admin rights during the deployment phase.




