Open in the explorer

Proxy settings

Type
Computer and user
GPO path
Computer Configuration › Policies › Administrative Templates › Google › Google Chrome User Configuration › Policies › Administrative Templates › Google › Google Chrome
Supported on
Microsoft Windows 7 or later
ADMX file
chrome.admx
Internal name
chrome/ProxySettings

Explanation

Setting the policy configures the proxy settings for Chrome and ARC-apps, which ignore all proxy-related options specified from the command line.

Leaving the policy unset lets users choose their proxy settings.

Setting the ProxySettings policy accepts the following fields:

* ProxyMode, which lets you specify the proxy server Chrome uses 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, which prevents the network stack from falling back to direct connections with invalid or unavailable PAC script

* ProxyServer, a URL of the proxy server

* ProxyBypassList, a list of hosts for which the proxy will be bypassed

The ProxyServerMode field is deprecated in favor of the ProxyMode field. For ProxyMode, if you choose the value:

* 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.

Note: For more detailed examples, visit The Chromium Projects ( https://www.chromium.org/developers/design-documents/network-settings/#command-line-options-for-proxy-settings ).
See https://chromeenterprise.google/policies/?policy=ProxySettings for more information about schema and formatting.

Example value:

{
"ProxyBypassList": "https://www.example1.com,https://www.example2.com,https://internalsite/",
"ProxyMode": "fixed_servers",
"ProxyServer": "123.123.123.123:8080"
}

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Google\Chrome
HKEY_CURRENT_USER\Software\Policies\Google\Chrome
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: chrome/ProxySettings
$k = 'HKLM:\Software\Policies\Google\Chrome'
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: chrome/ProxySettings
# No value is written in the "Disabled" state (nothing defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": chrome/ProxySettings
$k = 'HKLM:\Software\Policies\Google\Chrome'
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

Google Chrome (Google) — November 2026 templates

Official templates downloaded on November 12, 2026.