Skip to main content
Version: v3

UpgradeVersion Element

Description
None
Windows Installer references
Upgrade Table
Parents
Upgrade
Inner Text (xs:string)
This element may have inner text.
Children
None
Attributes
NameTypeDescriptionRequired
ExcludeLanguagesYesNoTypeSet to "yes" to detect all languages, excluding the languages listed in the Language attribute. 
IgnoreRemoveFailureYesNoTypeSet to "yes" to continue installation upon failure to remove a product or application. 
IncludeMaximumYesNoTypeSet to "yes" to make the range of versions detected include the value specified in Maximum. 
IncludeMinimumYesNoTypeSet to "no" to make the range of versions detected exclude the value specified in Minimum. This attribute is "yes" by default. 
LanguageStringSpecifies the set of languages detected by FindRelatedProducts. Enter a list of numeric language identifiers (LANGID) separated by commas (,). Leave this value null to specify all languages. Set ExcludeLanguages to "yes" in order detect all languages, excluding the languages listed in this value. 
MaximumStringSpecifies the upper boundary of the range of product versions detected by FindRelatedProducts. 
MigrateFeaturesYesNoTypeSet to "yes" to migrate feature states from upgraded products by enabling the logic in the MigrateFeatureStates action. 
MinimumStringSpecifies the lower bound on the range of product versions to be detected by FindRelatedProducts. 
OnlyDetectYesNoTypeSet to "yes" to detect products and applications but do not uninstall. 
PropertyStringWhen the FindRelatedProducts action detects a related product installed on the system, it appends the product code to the property specified in this field. Windows Installer documentation for the Upgrade table states that the property specified in this field must be a public property and must be added to the SecureCustomProperties property. WiX automatically appends the property specified in this field to the SecureCustomProperties property when creating an MSI. Each UpgradeVersion must have a unique Property value. After the FindRelatedProducts action is run, the value of this property is a list of product codes, separated by semicolons (;), detected on the system.Yes
RemoveFeaturesStringThe installer sets the REMOVE property to features specified in this column. The features to be removed can be determined at run time. The Formatted string entered in this field must evaluate to a comma-delimited list of feature names. For example: [Feature1],[Feature2],[Feature3]. No features are removed if the field contains formatted text that evaluates to an empty string. The installer sets REMOVE=ALL only if the Remove field is empty. 
Any Attribute (namespace='##other' processContents='lax') Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.
See Also
Wix Schema