From c7686a1242647cf2f6eeaf8ea9d26ea54767731d Mon Sep 17 00:00:00 2001 From: Imre Eilertsen Date: Tue, 24 Feb 2026 17:45:16 +0100 Subject: [PATCH 1/6] Update Settings.md --- doc/Settings.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/doc/Settings.md b/doc/Settings.md index 90bc94de3d..13dae11f42 100644 --- a/doc/Settings.md +++ b/doc/Settings.md @@ -8,6 +8,8 @@ Settings file is located in %LOCALAPPDATA%\Packages\Microsoft.DesktopAppInstalle If you are using the non-packaged WinGet version by building it from source code, the file will be located under %LOCALAPPDATA%\Microsoft\WinGet\Settings\settings.json +If you are creating a settings file from scratch, make sure that the line `"$schema": "https://aka.ms/winget-settings.schema.json",` is in it. + ## Source The `source` settings involve configuration to the WinGet source. @@ -180,7 +182,9 @@ The `architectures` behavior affects what architectures will be selected when in ### Installer Types -The `installerTypes` behavior affects 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 first (leftmost) ones are looked for first, which can be convenient for users who for instance prefer portable packages or MSIX/AppX installations. The matching parameter is `--installer-type`. + +Allowed parameters as of version 1.12.470 include: `appx`, `burn`, `exe`, `font`, `inno`, `msi`, `msix`, `msstore`, `nullsoft`, `portable`, `wix`, `zip` ```json "installBehavior": { @@ -190,6 +194,8 @@ The `installerTypes` behavior affects what installer types will be selected when }, ``` +If this setting is not set, Winget is known to default to the following value: `["inno", "wix", "msi", "nullsoft", "zip", "msix", "exe", "burn", "msstore", "portable"]` + ### Default install root The `defaultInstallRoot` affects the install location when a package requires one. This can be overridden by the `--location` parameter. This setting is only used when a package manifest includes `InstallLocationRequired`, and the actual location is obtained by appending the package ID to the root. From 421429fb768f857da3ef104a80463240ee6ddf28 Mon Sep 17 00:00:00 2001 From: Imre Eilertsen Date: Tue, 24 Feb 2026 18:07:50 +0100 Subject: [PATCH 2/6] Update Settings.md --- doc/Settings.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/Settings.md b/doc/Settings.md index 13dae11f42..1852d01811 100644 --- a/doc/Settings.md +++ b/doc/Settings.md @@ -186,6 +186,8 @@ The `installerTypes` behavior affects what installer types will be selected when Allowed parameters as of version 1.12.470 include: `appx`, `burn`, `exe`, `font`, `inno`, `msi`, `msix`, `msstore`, `nullsoft`, `portable`, `wix`, `zip` +If this setting is not set, Winget defaults to the installer type that is listed highest up in the manifest's installer YAML. + ```json "installBehavior": { "preferences": { @@ -194,8 +196,6 @@ Allowed parameters as of version 1.12.470 include: `appx`, `burn`, `exe`, `font` }, ``` -If this setting is not set, Winget is known to default to the following value: `["inno", "wix", "msi", "nullsoft", "zip", "msix", "exe", "burn", "msstore", "portable"]` - ### Default install root The `defaultInstallRoot` affects the install location when a package requires one. This can be overridden by the `--location` parameter. This setting is only used when a package manifest includes `InstallLocationRequired`, and the actual location is obtained by appending the package ID to the root. From 6ed42be2f256bad86d9cce73c0d3d1d7426c03ce Mon Sep 17 00:00:00 2001 From: Imre Eilertsen Date: Tue, 24 Feb 2026 18:09:41 +0100 Subject: [PATCH 3/6] Update Settings.md --- doc/Settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/Settings.md b/doc/Settings.md index 1852d01811..9f6970acda 100644 --- a/doc/Settings.md +++ b/doc/Settings.md @@ -186,7 +186,7 @@ The `installerTypes` behavior affects what installer types will be selected when Allowed parameters as of version 1.12.470 include: `appx`, `burn`, `exe`, `font`, `inno`, `msi`, `msix`, `msstore`, `nullsoft`, `portable`, `wix`, `zip` -If this setting is not set, Winget defaults to the installer type that is listed highest up in the manifest's installer YAML. +If this setting is not set, Winget defaults to the installer type that is listed highest up in the manifest's installer YAML (if the app has not been installed yet), or to the installer type that the existing installation of the package uses. ```json "installBehavior": { From aaddc19d9816a475fbf5f3a7215f47c403a88d2c Mon Sep 17 00:00:00 2001 From: Imre Eilertsen Date: Tue, 24 Feb 2026 18:34:48 +0100 Subject: [PATCH 4/6] Update doc/Settings.md Co-authored-by: JohnMcPMS --- doc/Settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/Settings.md b/doc/Settings.md index 9f6970acda..8bf81fa37e 100644 --- a/doc/Settings.md +++ b/doc/Settings.md @@ -184,7 +184,7 @@ The `architectures` behavior affects what architectures will be selected when in 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 first (leftmost) ones are looked for first, which can be convenient for users who for instance prefer portable packages or MSIX/AppX installations. The matching parameter is `--installer-type`. -Allowed parameters as of version 1.12.470 include: `appx`, `burn`, `exe`, `font`, `inno`, `msi`, `msix`, `msstore`, `nullsoft`, `portable`, `wix`, `zip` +Allowed values as of version 1.12.470 include: `appx`, `burn`, `exe`, `font`, `inno`, `msi`, `msix`, `msstore`, `nullsoft`, `portable`, `wix`, `zip` If this setting is not set, Winget defaults to the installer type that is listed highest up in the manifest's installer YAML (if the app has not been installed yet), or to the installer type that the existing installation of the package uses. From 363d331489a15e6d21675cafd624c6f4d3c7a8da Mon Sep 17 00:00:00 2001 From: Imre Eilertsen Date: Tue, 24 Feb 2026 18:35:39 +0100 Subject: [PATCH 5/6] Update doc/Settings.md Co-authored-by: JohnMcPMS --- doc/Settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/Settings.md b/doc/Settings.md index 8bf81fa37e..4476871490 100644 --- a/doc/Settings.md +++ b/doc/Settings.md @@ -186,7 +186,7 @@ The `installerTypes` behavior affects what installer types will be selected when Allowed values as of version 1.12.470 include: `appx`, `burn`, `exe`, `font`, `inno`, `msi`, `msix`, `msstore`, `nullsoft`, `portable`, `wix`, `zip` -If this setting is not set, Winget defaults to the installer type that is listed highest up in the manifest's installer YAML (if the app has not been installed yet), or to the installer type that the existing installation of the package uses. +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 da61749a8c4a80ea7a228eb7c24b7902b2c1fb71 Mon Sep 17 00:00:00 2001 From: Imre Eilertsen Date: Tue, 24 Feb 2026 18:35:54 +0100 Subject: [PATCH 6/6] Update doc/Settings.md Co-authored-by: JohnMcPMS --- doc/Settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/Settings.md b/doc/Settings.md index 4476871490..675d859dea 100644 --- a/doc/Settings.md +++ b/doc/Settings.md @@ -182,7 +182,7 @@ The `architectures` behavior affects what architectures will be selected when in ### Installer Types -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 first (leftmost) ones are looked for first, which can be convenient for users who for instance prefer portable packages or MSIX/AppX installations. 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`