Skip to content

Reflecting recent changes about installerTypes from https://github.com/microsoft/winget-cli/blob/master/doc/Settings.md #5837

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
DandelionSprout wants to merge 2 commits into
base: docs
Choose a base branch
from
Open

Reflecting recent changes about installerTypes from https://github.com/microsoft/winget-cli/blob/master/doc/Settings.md #5837

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
aac0dfb
Update settings.md
DandelionSprout Feb 25, 2026
b98d339
Update settings.md
DandelionSprout Feb 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion hub/package-manager/winget/settings.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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": {
Expand Down