Merge pull request #6329 from MicrosoftDocs/main

Auto Publish – main to live - 2026-02-27 05:00 UTC

Author: learn-build-service-prod[bot]

hub/apps/windows-dotnet-maui/images/hello-maui-add-mvvm-pkg.png

@@ -191,7 +191,11 @@ The `architectures` behavior controls what architectures will be selected when i
 
 #### installerTypes
 
-The `installerTypes` behavior controls what installer types will be selected when installing a package. The matching parameter is `--installer-type`.
+The `installerTypes` behavior affects what installer types will be selected when installing a package. It can also determine which type to install by default if a manifest has multiple types: The list is in priority order, with the first listed type being preferred over the others, and so on.  This is convenient for users who for instance prefer portable packages or MSIX/AppX installations. The matching parameter is `--installer-type`, which will override the settings.
+
+Allowed values as of version 1.12.470 include: `appx`, `burn`, `exe`, `font`, `inno`, `msi`, `msix`, `msstore`, `nullsoft`, `portable`, `wix`, `zip`
+
+By default, and with all other properties being equal, WinGet defaults to the installer type that is listed first in the manifest's installer YAML if the package has not been installed yet.  If it is already installed, the same installer type will be required to ensure a proper upgrade.
 
 ```json
     "installBehavior": {