Skip to main content
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 JSON
  • winget settings set - Sets admin settings
  • winget settings reset - Resets admin settings

Options

--enable
string
Enable an admin setting (requires administrator)
--disable
string
Disable an admin setting (requires administrator)

Examples

Open settings file:
winget settings
Enable admin setting:
winget settings --enable LocalManifestFiles
Disable admin setting:
winget settings --disable LocalManifestFiles

Settings File Location

Settings stored at:
%LOCALAPPDATA%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\settings.json

Settings File Format

{
  "$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 installations
  • BypassCertificatePinningForMicrosoftStore - Bypass certificate pinning
  • InstallerHashOverride - Allow hash override
  • LocalArchiveMalwareScanOverride - 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:
winget settings export
Output:
{
  "visual": {
    "progressBar": "rainbow"
  },
  "experimentalFeatures": {
    "configuration": true
  }
}
Save to file:
winget settings export > my-settings.json

winget settings set

Sets admin settings (requires administrator):
winget settings set <setting> <value>
Example:
winget settings set DefaultProxy "http://proxy.example.com:8080"

winget settings reset

Resets admin settings:
winget settings reset <setting>
Reset all admin settings:
winget settings reset --all

Exit Codes

  • 0 - Success
  • 0x80070005 - 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.

Build docs developers (and LLMs) love