Open in the explorer

Configure proxy server settings (deprecated)

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/ProxyMode

Explanation

DEPRECATED: This policy is deprecated. It is currently supported but will become obsolete in a future release.

This policy is deprecated and doesn't work in Microsoft Edge version 91. Use 'ProxySettings' (Proxy settings) instead.

If you set this policy to Enabled, you can specify the proxy server Microsoft Edge uses and prevents users from changing proxy settings. Microsoft Edge ignores all proxy-related options specified from the command line. The policy is only applied if the 'ProxySettings' policy isn't specified.

Other options are ignored if you choose one of the following options:
* direct = Never use a proxy server and always connect directly
* system = Use system proxy settings
* auto_detect = Auto detect the proxy server

If you choose to use:
* fixed_servers = Fixed proxy servers. You can specify further options with 'ProxyServer' (Configure address or URL of proxy server) and 'ProxyBypassList' (Configure proxy bypass rules).
* pac_script = A .pac proxy script. Use 'ProxyPacUrl' (Set the proxy .pac file URL) to set the URL to a proxy .pac file.

For detailed examples, go to https://go.microsoft.com/fwlink/?linkid=2094936.

If you don't configure this policy, users can choose their own proxy settings.

Policy options mapping:

* ProxyDisabled (direct) = Never use a proxy

* ProxyAutoDetect (auto_detect) = Auto detect proxy settings

* ProxyPacScript (pac_script) = Use a .pac proxy script

* ProxyFixedServers (fixed_servers) = Use fixed proxy servers

* ProxyUseSystem (system) = Use system proxy settings

Use the preceding information when configuring this policy.

Example value: direct

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/ProxyMode
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Configure proxy server settings
# Possible options:
#   Never use a proxy = direct
#   Auto detect proxy settings = auto_detect
#   Use a .pac proxy script = pac_script
#   Use fixed proxy servers = fixed_servers
#   Use system proxy settings = system
Set-ItemProperty -Path $k -Name 'ProxyMode' -Value 'direct' -Type String

Disable

# Disable: msedge/ProxyMode
# No value is written in the "Disabled" state (nothing defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": msedge/ProxyMode
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
Remove-ItemProperty -Path $k -Name 'ProxyMode' -ErrorAction SilentlyContinue

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Configure proxy server settingsProxyModeDrop-down listenumProxyModeREG_SZ
LabelValue
Never use a proxyREG_SZ = direct
Auto detect proxy settingsREG_SZ = auto_detect
Use a .pac proxy scriptREG_SZ = pac_script
Use fixed proxy serversREG_SZ = fixed_servers
Use system proxy settingsREG_SZ = system

Application

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

Official templates downloaded on November 12, 2026.