Automatic Upgrade Item Settings

InstallShield 2025 » Upgrades View » Automatic Upgrade Item

Project: This information applies to the following project types:

•

Basic MSI

•

InstallScript MSI

Note:This is the preferred method for configuring upgrade settings. This option takes into account any potential future changes in the product code and handles both major and minor upgrades. If you do not know the difference between upgrade types and/or do not care, then choose this upgrade option.

When you add an automatic upgrade item, the build engine determines which settings need to be populated into your setup to perform a successful upgrade of your previous setup. This option does not require any additional authoring of advanced settings on your part.

You can configure the following options for an automatic upgrade item in the Upgrades view:

Options for Automatic Upgrade Items
Option	Description
Setup to Upgrade	Enter the path to the setup project that needs to be upgraded or click the browse button to browse for it.
Release Flags	Associating a release flag with the automatic upgrade item will allow you to optionally exclude it from the build on a per release basis.

Settings.xml Configuration Support in Automatic Upgrade Behavior

InstallShield includes a property named LanguagesExclusiveAttributeInAutoUpgrade in the Settings.xml file that enhances the behavior of the Automatic Upgrade items in projects that support multiple languages, helping ensure more predictable and efficient upgrade execution. This property provides control over whether the languages listed in the Language column—of the Upgrade table in the Direct Editor view—for a given automatic upgrade item should be excluded in the upgrade condition.

Setting the LanguagesExclusiveAttributeInAutoUpgrade property to Yes excludes or removes all the languages listed in the Language column for a given automatic upgrade item.