Open in the explorer

Proxy settings

Type
Computer and user
GPO path
Computer Configuration › Policies › Administrative Templates › Microsoft Edge › Proxy server User Configuration › Policies › Administrative Templates › Microsoft Edge › Proxy server
Supported on
Microsoft Edge version 77, Windows 7 or later
ADMX file
msedge.admx
Internal name
msedge/ProxySettings

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\Edge
HKEY_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 String

Disable

# 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 SilentlyContinue

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Proxy settingsProxySettingsText boxtextProxySettingsREG_SZ
Max length: 1000000

Application

Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates

Official templates downloaded on November 12, 2026.