logo
search
Office Installation Errors

Can the Office Deployment Tool Install a Word XML Add-In?

Amos GikundaAmos Gikunda Oct 8, 2026 869 views

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.

Can the Office Deployment Tool Install a Word XML Add-In?
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.
Before you start

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.

Solution 1Recommended

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.

1
Access the Admin Center

Sign in to the Microsoft 365 admin center using your global or Exchange administrator credentials.

2
Navigate to Integrated Apps

Go to 'Settings' in the left-hand navigation pane, select 'Integrated apps', and then click on 'Add-ins'.

3
Upload the XML Manifest

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.

4
Assign Users and Deploy

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.

Deploy the XML Add-In via Microsoft 365 Admin Center
Deployment Complete: Centralized Deployment ensures the add-in automatically appears in the Word ribbon for assigned users without requiring local manual installations.
Free Microsoft Office alternative

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. 1. Download the Installer: Visit the official WPS Office website and download the free, lightweight installer package.
  2. 2. Deploy Across Computers: Run the setup file to easily install the suite across your devices without needing complex deployment tools.
  3. 3. Open Your Documents: Launch WPS Office to instantly open, edit, and save your existing Word documents seamlessly.
Highly compatible with Microsoft Word formats (.docx, .doc, .dotx) and XML-based document structures.Lightweight installation package that is significantly easier to deploy across tenant computers.Rich built-in tools for document editing, PDF conversion, and team collaboration natively included.Familiar user interface ensuring seamless migration with zero learning curve for end-users.
QA img-9

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.