Skip to content

Commit aac0dfb

Browse files
Update settings.md
1 parent 4d76161 commit aac0dfb

1 file changed

Lines changed: 7 additions & 1 deletion

File tree

hub/package-manager/winget/settings.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,8 @@ The code snippet below shows an example of what your settings file might look li
6969
}
7070
```
7171

72+
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.
73+
7274
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.
7375

7476
## Updating settings
@@ -191,7 +193,11 @@ The `architectures` behavior controls what architectures will be selected when i
191193

192194
#### installerTypes
193195

194-
The `installerTypes` behavior controls what installer types will be selected when installing a package. The matching parameter is `--installer-type`.
196+
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.
197+
198+
Allowed values as of version 1.12.470 include: `appx`, `burn`, `exe`, `font`, `inno`, `msi`, `msix`, `msstore`, `nullsoft`, `portable`, `wix`, `zip`
199+
200+
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.
195201

196202
```json
197203
"installBehavior": {

0 commit comments

Comments
 (0)