Proxy settings
Explanation
Configures the proxy settings for Microsoft Edge.
If you enable this policy, Microsoft Edge ignores all proxy-related options specified from the command line.
If you don't configure this policy, users can choose their own proxy settings.
This policy overrides the following individual policies:
'ProxyMode' (Configure proxy server settings)
'ProxyPacUrl' (Set the proxy .pac file URL)
'ProxyServer' (Configure address or URL of proxy server)
'ProxyBypassList' (Configure proxy bypass rules)
Setting the 'ProxySettings' (Proxy settings) policy accepts the following fields:
* ProxyMode, which lets you specify the proxy server used by Microsoft Edge and prevents users from changing proxy settings
* ProxyPacUrl, a URL to a proxy .pac file or a PAC script encoded as a data URL with MIME type application/x-ns-proxy-autoconfig
* ProxyPacMandatory, a boolean flag that prevents the network stack from falling back to direct connections with invalid or unavailable PAC script
* ProxyServer, a URL for the proxy server
* ProxyBypassList, a list of proxy hosts that Microsoft Edge bypasses
For ProxyMode, the following values when chosen lead to the following results:
* direct, a proxy is never used and all other fields are ignored.
* system, the systems's proxy is used and all other fields are ignored.
* auto_detect, all other fields are ignored.
* fixed_servers, the ProxyServer and ProxyBypassList fields are used.
* pac_script, the ProxyPacUrl, ProxyPacMandatory and ProxyBypassList fields are used.
For more detailed examples, see https://go.microsoft.com/fwlink/?linkid=2094936.
Example value:
{
"ProxyBypassList": "https://www.example1.com,https://www.example2.com,https://internalsite/",
"ProxyMode": "pac_script",
"ProxyPacMandatory": false,
"ProxyPacUrl": "https://internal.site/example.pac",
"ProxyServer": "123.123.123.123:8080"
}
Compact example value:
{"ProxyBypassList": "https://www.example1.com,https://www.example2.com,https://internalsite/", "ProxyMode": "pac_script", "ProxyPacMandatory": false, "ProxyPacUrl": "https://internal.site/example.pac", "ProxyServer": "123.123.123.123:8080"}
Registry
HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\EdgeHKEY_CURRENT_USER\Software\Policies\Microsoft\Edge- Value name
- not defined in the ADMX
Enable / disable values: not defined in the ADMX (see the options below).
PowerShell
PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.
Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.
Computer (HKLM)
Enable
# Enable: msedge/ProxySettings
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Proxy settings
Set-ItemProperty -Path $k -Name 'ProxySettings' -Value '<value>' -Type StringDisable
# Disable: msedge/ProxySettings
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": msedge/ProxySettings
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
Remove-ItemProperty -Path $k -Name 'ProxySettings' -ErrorAction SilentlyContinueUser (HKCU)
Enable
Disable
Revert to "Not configured"
Options (1)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Proxy settingsProxySettings | Text boxtext | ProxySettings | REG_SZ | Max length: 1000000 |
Application
Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.