Documentation Index
Fetch the complete documentation index at: https://mintlify.com/microsoft/winget-cli/llms.txt
Use this file to discover all available pages before exploring further.
The settings command opens the WinGet settings file in the default editor or manages admin settings.
Syntax
winget settings [options]
Subcommands
winget settings export - Exports current settings to JSONwinget settings set - Sets admin settingswinget settings reset - Resets admin settings
Options
Enable an admin setting (requires administrator)
Disable an admin setting (requires administrator)
Examples
Open settings file:
Enable admin setting:
winget settings --enable LocalManifestFiles
winget settings --disable LocalManifestFiles
Settings File Location
Settings stored at:
%LOCALAPPDATA%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\settings.json
{
"$schema": "https://aka.ms/winget-settings.schema.json",
"visual": {
"progressBar": "rainbow"
},
"experimentalFeatures": {
"configuration": true
},
"installBehavior": {
"preferences": {
"scope": "user",
"locale": ["en-US", "en-GB"]
}
},
"source": {
"autoUpdateIntervalInMinutes": 1440
},
"network": {
"downloader": "wininet",
"doProgressTimeoutInSeconds": 60
}
}
Common Settings
Visual
"visual": {
"progressBar": "rainbow", // "accent", "rainbow", "retro", "plain"
"anonymizePathForDisplay": true
}
Install Behavior
"installBehavior": {
"preferences": {
"scope": "user", // "user" or "machine"
"locale": ["en-US"],
"architectures": ["x64", "x86"]
},
"skipDependencies": false
}
Experimental Features
"experimentalFeatures": {
"configuration": true,
"directMSI": true,
"windowsFeature": false
}
Source
"source": {
"autoUpdateIntervalInMinutes": 1440
}
Network
"network": {
"downloader": "wininet", // "wininet", "do" (Delivery Optimization)
"doProgressTimeoutInSeconds": 60
}
Admin Settings
Admin settings require administrator privileges and are system-wide.
Available Admin Settings
LocalManifestFiles - Allow local manifest installationsBypassCertificatePinningForMicrosoftStore - Bypass certificate pinningInstallerHashOverride - Allow hash overrideLocalArchiveMalwareScanOverride - Allow skipping malware scan
Enable Admin Setting
winget settings --enable LocalManifestFiles
Disable Admin Setting
winget settings --disable LocalManifestFiles
winget settings export
Exports current settings to stdout:
Output:
{
"visual": {
"progressBar": "rainbow"
},
"experimentalFeatures": {
"configuration": true
}
}
winget settings export > my-settings.json
winget settings set
Sets admin settings (requires administrator):
winget settings set <setting> <value>
winget settings set DefaultProxy "http://proxy.example.com:8080"
winget settings reset
Resets admin settings:
winget settings reset <setting>
winget settings reset --all
Exit Codes
0 - Success0x80070005 - Access denied (admin settings require administrator)0x8A150043 - Invalid setting name
Changes to settings.json take effect immediately without restarting WinGet.
Admin settings affect all users on the system. Use with caution.