Upgrade Codes

The upgrade code is the GUID that identifies your product across versions and ensures new MSI versions can upgrade previeous MSI versions.

"msi": {
  "upgradeCode": "{NEW-GUID-HERE}"
}

Generate one once per product:
Generate unique GUID with PowerShell: [guid]::NewGuid().ToString("B").ToUpper()

`secondaryUpgradeCodes`

If your product previously shipped your MSI with different upgrade codes, list them here so the new installer your are building right now can find and uninstall those old versions too.

"msi": {
  "upgradeCode": "{NEW-GUID-HERE}",
  "secondaryUpgradeCodes": [
    {
      "upgradeCode": "{OLD-LEGACY-GUID-HERE}",
      "version":     "1.0.0"
    }
  ]
}

Property	Type	Required	Default	Description
`upgradeCode`	`string` (GUID)	yes	–	The previous product's upgrade code. Must be unique across all entries (and must not equal the primary).
`version`	`string`	no	`$.version`	Highest legacy version to upgrade FROM. Format `Major.Minor.Build` (Major ≤ 255, Minor ≤ 255, Build ≤ 65535).

secondaryUpgradeCodes​

`secondaryUpgradeCodes`