Office Click-To-Run Configuration XML Editor

Add Product
Remove Product
Updates
Display
Logging
Templates

Add Product

Product

Edition

Language

Optional

Version

SourcePath

PIDKEY

Exclude Office Programs

Properties

AutoActivate

ForceAppShutdown

SharedComputerLicensing

PACKAGEGUID

Add Remove Product

Product

Language

Updates

UpdatePath

TargetVersion

Deadline

Display

Level

AcceptEULA

Logging

Level

Path

Templates

Office 365 ProPlus Retail
Office 365 ProPlus Business
Office 365 ProPlus Retail with Visio

XML Viewer

Help

Office Click-To-Run Configuration XML Editor

Online Editor for the Office ProPlus Click-To-Run Configurtion XML file

This page provides a graphical method to generate and edit the Office Click-to-Run configuration.xml file

Reference for Click-to-Run configuration.xml file

The Click-to-Run for Office 365 Configuration.xml file is used to specify Click-to-Run installation and update options. The Office Deployment Tool is a downloadable tool that includes a sample Configuration.xml file. Administrators can modify the Configuration.xml file to configure installation options for Click-to-Run for Office 365 products.

The Click-to-Run Configuration.xml file is a necessary component of the Office Deployment Tool. Click-to-Run customizations are performed primarily by starting the Office Deployment Tool and providing a custom Configuration.xml file. The Office Deployment Tool performs the tasks that are specified by using the optional properties in the configuration file. For the Office 2013 release of the product, administrators can download the Office Deployment Tool from the Microsoft Download Center.

Help

Office Product

Specifies the Click-to-Run product to install.

Required. ID must be set to a valid ProductRelease ID.

The supported ProductRelease IDs for Click-to-Run for Office 365 products are as follows:

O365ProPlusRetail
O365BusinessRetail
VisioProRetail
ProjectProRetail
SPDRetail (SharePoint Designer)

If ID is not set, the operation fails and indicates that the input is not valid.

The order of Product elements determines the order in which the products are installed. The first Product ID is used to determine in which context the Microsoft Office First Run Experience application starts. Microsoft Office First Run Experience refers to the first time each Office application starts.

Help

Office Client Edition

Specifies the edition of Click-to-Run for Office 365 product to use: 32- or 64-bit.

Required. Specifies the edition of Click-to-Run for Office 365 product to use: 32- or 64-bit. The action fails if OfficeClientEdition is not set to a valid value.

A configure mode action may fail if OfficeClientEdition is set incorrectly. For example, if you attempt to install a 64-bit edition of a Click-to-Run for Office 365 product on a computer that is running a 32-bit Windows operating system, or if you try to install a 32-bit Click-to-Run for Office 365 product on a computer that has a 64-bit edition of Office installed.

Help

Product Language

Determine which product languages to install.

Required. If the Language ID value is not set, the installation operation fails and indicates that the input is not valid.

The ID value can be set to a valid Office culture language (such as en-us for English US or ja-jp for Japanese). The ll-cc value is the language identifier.

Note:
Language elements determine which product languages to install. Administrators must specify the languages they want to install. The first language determines the Shell UI culture. The Shell UI is the language of shortcuts, right-click context menus, and tooltips. If you decide that you want to change the Shell UI language after an initial installation, you have to uninstall Click-to-Run and reinstall. Add the language that you want to set for the Shell UI as the first language in the custom Configuration.xml file.

Note:

Language elements determine which product languages to install. Administrators must specify the languages they want to install. The first language determines the Shell UI culture. The Shell UI is the language of shortcuts, right-click context menus, and tooltips.
If you decide that you want to change the Shell UI language after an initial installation, you have to uninstall Click-to-Run and reinstall. Add the language that you want to set for the Shell UI as the first language in the custom Configuration.xml file.

Help

Product Version

The Version of the Click-to-Run product to installation

Optional. If a Version value is not set, the Click-to-Run product installation streams the latest available version from the source. The default is to use the most recently advertised build (as defined in v32.CAB or v64.CAB at the Click-to-Run Office installation source).

Version can be set to an Office 2013 build number by using this format: X.X.X.X

For more information on the specific versions of Office Click-To-Run see Update Office 2013 or Office 365

Help

Source Path

Indicates the location to save the Click-to-Run installation source when you run the Office Deployment Tool in download mode.

Optional.

The SourcePath value can be set to a network, local, or HTTP path that contains a Click-to-Run source. Environment variables can be used for network or local paths.

SourcePath indicates the location to save the Click-to-Run installation source when you run the Office Deployment Tool in download mode.

SourcePath indicates the installation source path from which to install Office when you run the Office Deployment Tool in configure mode. If you don’t specify SourcePath in configure mode, Setup will look in the current folder for the Office source files. If the Office source files aren’t found in the current folder, Setup will look on Office 365 for them.

SourcePath specifies the path of the Click-to-Run Office source from which the App-V package will be made when you run the Office Deployment Tool in packager mode.

If you do not specify SourcePath, Setup will attempt to create an \Office\Data\... folder structure in the working directory from which you are running setup.exe.

Help

PIDKEY

The 25-character volume license key.

Optional.

When the PIDKEY value is set, users are not required to enter a product key when they install Office.

If this element is not defined, the default settings are used. If an invalid value is specified, Setup ends the installation.

If the Level attribute is set to "basic" or “none” and you supply a product key by using the PIDKEY, Setup assumes that you also accept the license agreement on behalf of the user.

Help

ExcludeApp

Specifies which Office programs not to install.

Optional.

The following is a list of the supported values for ID:

Access
Excel
Groove
InfoPath
Lync
OneNote
Outlook
PowerPoint
Project
Publisher
SharePointDesigner
Visio
Word

The value “Groove” is used to exclude OneDrive for Business.

The value "Lync" also applies to Skype for Business.

The following example shows how to install the 32-bit edition of Office 365 ProPlus in English, without Access or InfoPath.

Help

Remove Products

Removes products and languages.

Important:
To remove an installed language for a product, you must specify the ID for the product, and specify the ID for the language that you want to remove. To remove a product completely, you must specify the ID for the product, and specify the IDs of all the languages that are installed. But, if the product and languages are also specified in the Add element of the configuration.xml file, then the product or languages won’t be removed. If All is set to TRUE, then all products and languages are removed, regardless of what is specified in the Add element.

Important:

To remove an installed language for a product, you must specify the ID for the product, and specify the ID for the language that you want to remove. To remove a product completely, you must specify the ID for the product, and specify the IDs of all the languages that are installed. But, if the product and languages are also specified in the Add element of the configuration.xml file, then the product or languages won’t be removed.
If All is set to TRUE, then all products and languages are removed, regardless of what is specified in the Add element.

Help

Update Path

Specifies a network, local, or HTTP path of a Click-to-Run source.

Optional.

If UpdatePath is not set, Click-to-Run installations obtain updates from the Microsoft Click-to-Run source (Content Delivery Network or CDN). This is by default. If UpdatePath is set to empty (""), updates are obtained from the Microsoft Click-to-Run source, CDN. UpdatePath can specify a network, local, or HTTP path of a Click-to-Run source. Environment variables can be used for network or local paths. If you use Group Policy and the Office 2013 Administrative Template files (ADMX/ADML), you can set UpdatePath by using the Update Path policy setting. You can find this policy setting under Computer Configuration\Administrative Templates\Microsoft Office 2013 (Machine)\Updates.

Help

Target Version

The Click-to-Run product version to install.

Optional.

If TargetVersion is not set, Click-to-Run updates to the most recent version from the Microsoft Click-to-Run source. If TargetVersion is set to empty (""), Click-to-Run updates to the latest version from the Microsoft Click-to-Run source. TargetVersion can be set to an Office build number, for example, 15.1.2.3. When the version is set, Office attempts to transition to the specified version in the next update cycle. If you use Group Policy and the Office 2013 Administrative Template files (ADMX/ADML), you can set TargetVersion by using the Target Version policy setting. You can find this policy setting under Computer Configuration\Administrative Templates\Microsoft Office 2013 (Machine)\Updates.

For more information on the specific versions of Office Click-To-Run see Update Office 2013 or Office 365

Help

Deadline

Sets a deadline by when updates to Office must be applied. The deadline is specified in Coordinated Universal Time (UTC).

Optional.

Sets a deadline by when updates to Office must be applied. The deadline is specified in Coordinated Universal Time (UTC). You can use Deadline with Target Version to make sure that Office is updated to a particular version by a particular date. We recommend that you set the deadline at least a week in the future to allow users time to install the updates. Prior to the deadline, users receive multiple reminders to install the updates. If Office isn’t updated by the deadline, users see a notification that the updates will be applied in 15 minutes. This gives users the opportunity to save the Office documents that they are working on and to close any Office programs that are open. If users don’t close the Office programs, the programs are closed automatically when the 15 minutes are up, which might result in data loss. After the Office programs are closed, the updates are applied automatically. The deadline only applies to one set of updates. If you want to use a deadline to make sure that Office is always up-to-date, you must change the deadline every time that a new update for Office is available. To use this attribute, Office must be running at least Service Pack 1 (version 15.0.4569.1507) and you must use at least version 15.0.4595.1000 of the Office Deployment Tool. If you use Group Policy and the Office 2013 Administrative Template files (ADMX/ADML), you can set Deadline by using the Update Deadline policy setting. You can find this policy setting under Computer Configuration\Administrative Templates\Microsoft Office 2013 (Machine)\Updates.

Help

Level

Determines the user interface that the user sees when the operation is performed.

Optional.

If Level is set to None, the user sees no UI. No progress UI, completion screen, error dialog boxes, or first run automatic start UI are displayed. If Level is set to Full, the user sees the normal Click-to-Run user interface: Automatic start, application splash screen, and error dialog boxes.

Help

Accept Eula

We recommend that administrators set AcceptEULA to TRUE.

Optional.

If this attribute is set to TRUE, the user does not see a Microsoft Software License Terms dialog box. If this attribute is set to FALSE or is not set, the user may see a Microsoft Software License Terms dialog box. This attribute only applies if you install with the user's account. If you use System Center Configuration Manager or some other software distribution tool which uses the SYSTEM account to install, then the setting for this attribute is not applied.

Help

Log Level

Specifies options for the logging that Click-to-Run Setup performs.

Optional.

The default level is Standard.

Help

Log Path

Specifies the fully qualified path of the folder that is used for the log file.

Optional.

You can use environment variables. The default is %temp%.

Help

PACKAGEGUID

App-V Package ID.

Optional.

By default, all Office 2013 App-V packages created by using the Office Deployment Tool share the same App-V Package ID. Administrators can use PACKAGEGUID to specify a different Package ID. You can only use the following characters for PACKAGEGUID:

0, 1, 2, 3, 4, 5, 6, 7, 8, 9
A, B, C, D, E, F

If you use any other characters, the App-V package is created with the default Package ID. Also, PACKAGEGUID needs to be 25 characters in length and be separated into 5 sections, with each section separated by a dash. The sections need to have the following number of characters: 8, 4, 4, 4, and 12. For example, 12345678-ABCD-1234-ABCD-1234567890AB is a valid value for PACKAGEGUID. This allows you to publish multiple App-V packages of Office 2013 to an App-V Management Server. But, this doesn’t enable you to deploy more than one Office 2013 App-V package to a single computer.

Help

AUTOACTIVATE

Specified products will attempt to activate automatically.

If AUTOACTIVATE is set to 1, the specified products will attempt to activate automatically. If AUTOACTIVATE is not set, the user may see the Activation Wizard UI.

Note: Office 365 Click-to-Run products are already set to activate automatically. You must not set AUTOACTIVATE for Office 365 Click-to-Run products.
This setting applies only to perpetual retail versions of Click-to-Run products.

Help

FORCEAPPSHUTDOWN

Forces the applications that block the action to be shut down.

An installation or removal action may be blocked if Office applications are running. Normally, such cases would start a process killer UI. Administrators can set FORCEAPPSHUTDOWN value to TRUE to prevent dependence on user interaction. When FORCEAPPSHUTDOWN is set to TRUE, any applications that block the action will be shut down. Data loss may occur. When FORCEAPPSHUTDOWN is set to FALSE (default), the action may fail if Office applications are running.

Help

SharedComputerLicensing

Forces the applications that block the action to be shut down.

Optional.

Set SharedComputerLicensing to 1 if you deploy Office 365 ProPlus to shared computers by using Remote Desktop Services. For more information, see Overview of shared computer activation for Office 365 ProPlus.