Edit

Share via

Remove existing MSI versions of Office when upgrading to Microsoft 365 Apps

  • Article

Uninstall any previous versions of Office before installing Microsoft 365 Apps. Use the Office Deployment Tool and specify the RemoveMSI element in your configuration.xml file to uninstall Office versions that use Windows Installer (MSI).

You can use the RemoveMSI element in several ways when installing Microsoft 365 Apps:

  • Uninstall all Office products on the computer.
  • Identify existing language resources, like language packs, and install the same languages.
  • Keep specific Office products and uninstall all others on the computer.

RemoveMSI uninstalls 2007, 2010, 2013, or 2016 versions of Office, Visio, or Project installed using Windows Installer (MSI).

Note

RemoveMSI doesn't uninstall prior versions of Office, including Visio and Project, that use Click-to-Run as the installation technology. Uninstall those versions of Office through Control Panel or by running the Office Deployment Tool and using the Remove element in your configuration.xml file.

Requirements for using RemoveMSI

These are the requirements for using the RemoveMSI element in your configuration.xml file:

  • Use at least version 16.0.12827.20268 (setup.exe version 16.0.12827.20258) of the Office Deployment Tool, which you can download from Microsoft Download Center. Always download and use the most current version of the Office Deployment Tool. To check the version, right-click setup.exe, choose Properties, and then choose Details.
  • Install at least Version 1803 of Microsoft 365 Apps. Version 1803 or later is available in Current Channel, Monthly Enterprise Channel, Semi-Annual Enterprise Channel (Preview), and Semi-Annual Enterprise Channel.
  • Install Microsoft 365 Apps on a computer running at least Windows 7 Service Pack 1 (SP1) or newer.

Note

Support for Windows 7 ended on January 14, 2020. For more information, see Windows 7 end of support and Microsoft 365 Apps.

Uninstall all Office products

To uninstall all versions of Office, including Visio and Project, already installed on the computer, add <RemoveMSI /> to your configuration.xml file. Language resources, such as language packs, language interface packs, or proofing tools, are also removed.

Here’s an example of a configuration.xml file. It installs the 64-bit Current Channel version of Microsoft 365 Apps for enterprise in English from the Office Content Delivery Network (CDN). It also uninstalls any Windows Installer (MSI) versions of Office.

<Configuration>
  <Add OfficeClientEdition="64" Channel="Current" >
      <Product ID="O365ProPlusRetail">
         <Language ID="en-us" />
      </Product>
  </Add>
  <RemoveMSI />
</Configuration>

Install the same language resources

If language resources, such as language packs, language interface packs, or proofing tools, are already installed on the computer, you can install Click-to-Run versions of the same language resources when you install Microsoft 365 Apps. To install the same language resources, add <Language ID="MatchPreviousMSI" /> to your configuration.xml file.

Here’s an example of a configuration.xml file. It installs the 64-bit Monthly Enterprise Channel version of Microsoft 365 Apps for enterprise in English. It also includes any existing languages on the computer. The installation is from the Office Content Delivery Network (CDN). Additionally, it uninstalls any Windows Installer (MSI) versions of Office.

<Configuration>
  <Add OfficeClientEdition="64" Channel="MonthlyEnterprise" >
      <Product ID="O365ProPlusRetail">
         <Language ID="en-us" />
         <Language ID="MatchPreviousMSI" />
      </Product>
  </Add>
  <RemoveMSI />
</Configuration>

Details about using MatchPreviousMSI in your configuration.xml file:

  • Include the RemoveMSI element.
  • Specify at least one language ID, such as en-us.
  • The setting isn’t product specific. For example, if you have Office Professional Plus 2013 in French and Visio Standard 2013 in German installed, you get both French and German when you install Microsoft 365 Apps. Any other language IDs you specified are also included.

Important

If you’re installing Microsoft 365 Apps from a location on your local network, such as a shared folder, ensure you’ve downloaded all the possible language files to that folder. If any required languages aren’t available in that folder, the installation continues without those languages. To avoid this, include AllowCdnFallback="True" in your configuration.xml file. This uses the Office Content Delivery Network (CDN) on the internet as a backup source for installing the language files.

Keep some Office products and uninstall all other Office products

Uninstall any previous versions of Office, including Visio and Project, before installing the newer version. In some cases, such as for application compatibility testing, you might need to keep a previous version installed temporarily while transitioning to the new version.

To keep a specific Office product, add an IgnoreProduct line to your configuration.xml file and specify its product ID.

Examples of supported IDs for Project and Visio:

  • PrjStd
  • PrjPro
  • VisStd
  • VisPro
  • PrjStdR
  • PrjProR
  • VisStdR
  • VisProR

Note

The product ID is the Setup ID found in the Setup.xml file in the {product}.WW folder of the installation files for your previous version of Office. For example, the Setup.xml file for Office Professional Plus 2010 is in the ProPlus.WW folder.

The ID isn’t version specific. All versions found on the computer are kept. For example, if you specify VisPro, both Visio Professional 2016 and Visio Professional 2013 are kept. Language resources for those versions are also kept, such as language packs, language interface packs, or proofing tools.

Only full product removals are supported. For example, if you have Office Professional Plus 2013 installed, you can’t uninstall everything except Excel. You must keep or uninstall the entire product. You can only keep a previous installation of Excel if it was installed as a standalone product, not as part of an Office suite, like Office Professional Plus.

Here’s an example of a configuration.xml file. It installs the 64-bit Monthly Enterprise Channel version of Microsoft 365 Apps for enterprise in English from the Office Content Delivery Network (CDN). It also uninstalls any Windows Installer (MSI) versions of Office on the computer, except for Visio Professional.

<Configuration>
  <Add OfficeClientEdition="64" Channel="MonthlyEnterprise">
      <Product ID="O365ProPlusRetail ">
         <Language ID="en-us" />
      </Product>
  </Add>
  <RemoveMSI>
    <IgnoreProduct ID="VisPro" />
  </RemoveMSI>
</Configuration>

Other products that can be removed

Installations of the following products are removed by using the RemoveMSI element unless you use IgnoreProduct:

  • SharePoint Designer. The product ID is SharePointDesigner.
  • InfoPath. The product ID is either InfoPath (for volume licensed versions) or InfoPathR (for retail versions).
  • Lync 2013 or later.

Note

Lync 2010 can’t be removed by using the RemoveMSI element.

  • Office products installed separately and not as part of an Office suite. For example, a standalone installation of Access.
  • Access 2010 Runtime or later. The product ID is AccessRT.
  • Access Database Engine 2010 Redistributable or later. The product ID is AceRedist.

Note

Access Database Engine is most commonly included as part of other applications that interact with Access data sources. Uninstalling Access Database Engine could affect the functionality of these applications. Before removing Access Database Engine, ensure that any applications requiring this component are removed or no longer needed.

Additional information about using RemoveMSI

These are additional details about using the RemoveMSI element in your configuration.xml file:

  • Use these settings if you’re installing any of the following products:
    • Microsoft 365 Apps for enterprise (previously named Office 365 ProPlus)
    • Microsoft 365 Apps for business (previously named Office 365 Business)
    • The subscription version of the Project desktop app that comes with Planner and Project Plan 3 or Planner and Project Plan 5.
    • The subscription version of the Visio desktop app that comes with Visio Plan 2.
    • Office LTSC Professional Plus 2021 or Office LTSC Standard 2021.
    • A volume licensed version of Office 2019, such as Office Professional Plus 2019.
  • User settings, preferences, and documents are retained, even if you’re uninstalling all Office products.
  • Use the RemoveMSI element with the MSICondition attribute. This attribute lets you control the installation of an Office product based on whether a particular MSI-based product is already installed on the device. For example, only install Project Online Desktop Client if Project Professional is already installed on the device. For more information, see MSICondition attribute or watch Upgrading to Microsoft 365 Apps with MSICondition and RemoveMSI.
  • Some previous versions of Office, Visio, and Project must be uninstalled before installing Microsoft 365 Apps. For example, Office Professional Plus 2016. If they aren’t uninstalled beforehand, the installation of Microsoft 365 Apps fails. For more information, see Supported scenarios for installing different versions of Office, Visio, and Project on the same computer.
  • A reboot is required to finish uninstalling the Windows Installer (MSI) versions of Office, but the reboot isn’t enforced. You can reboot after the Microsoft 365 Apps installation is finished.
  • Removing a product might fail if the product is open on the user's device. This failure can happen if the Level attribute or the Display element in your configuration.xml file is set to None. If you set the Level attribute to Full, the user is prompted to close the program so the removal can continue. You can use the FORCEAPPSHUTDOWN property, but that could result in data loss.
  • If you use RemoveMSI on a Windows 7 SP1 computer, pinned shortcuts created by the user might sometimes remain. This can happen even if the previous version of Office and all its other shortcuts have been removed. To remove the pinned shortcut, select it, and you'll be prompted to remove it. Or, sign in as the user who created the pinned shortcut, and then run the Office Deployment Tool to upgrade to Microsoft 365 Apps.