From aac0dfbcfe3ba8c913fa8b002e2d76d92b3c10d5 Mon Sep 17 00:00:00 2001 From: Imre Eilertsen Date: Wed, 25 Feb 2026 10:28:52 +0100 Subject: [PATCH 1/2] Update settings.md --- hub/package-manager/winget/settings.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/hub/package-manager/winget/settings.md b/hub/package-manager/winget/settings.md index 5440019520..146928ca63 100644 --- a/hub/package-manager/winget/settings.md +++ b/hub/package-manager/winget/settings.md @@ -69,6 +69,8 @@ The code snippet below shows an example of what your settings file might look li } ``` +In particular, the `"$schema": "https://aka.ms/winget-settings.schema.json",` line is required in order for any of the file's settings to be applied. + We have also defined a schema for the settings file. This allows you to use TAB to discover settings and syntax if your JSON editor supports JSON schemas. ## Updating settings @@ -191,7 +193,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": { From b98d339b99c98715ee41c196589b7d83a9c50569 Mon Sep 17 00:00:00 2001 From: Imre Eilertsen Date: Thu, 26 Feb 2026 13:51:01 +0100 Subject: [PATCH 2/2] Update settings.md --- hub/package-manager/winget/settings.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/hub/package-manager/winget/settings.md b/hub/package-manager/winget/settings.md index 146928ca63..56f8d5556b 100644 --- a/hub/package-manager/winget/settings.md +++ b/hub/package-manager/winget/settings.md @@ -69,8 +69,6 @@ The code snippet below shows an example of what your settings file might look li } ``` -In particular, the `"$schema": "https://aka.ms/winget-settings.schema.json",` line is required in order for any of the file's settings to be applied. - We have also defined a schema for the settings file. This allows you to use TAB to discover settings and syntax if your JSON editor supports JSON schemas. ## Updating settings