Proxy settings
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\ChromeHKEY_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 StringDisable
# 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 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
Google Chrome (Google) — November 2026 templates
Official templates downloaded on November 12, 2026.