Open in the explorer

Enable or disable the User-Agent Reduction (obsolete)

Type
Computer and user
GPO path
Computer Configuration › Policies › Administrative Templates › Microsoft Edge User Configuration › Policies › Administrative Templates › Microsoft Edge
Supported on
Microsoft Edge version 99-144, Windows 7 or later
ADMX file
msedge.admx
Internal name
msedge/UserAgentReduction

Explanation

OBSOLETE: This policy is obsolete and doesn't work after Microsoft Edge 144.

The User-Agent HTTP request header has been reduced by default since Microsoft Edge version 119. To continue receiving detailed platform information, migrate to User-Agent Client Hints, which replace the deprecated detailed User-Agent header. For more information, visit: https://web.dev/articles/migrate-to-ua-ch

If you don't configure this policy or set it to Default, the User-Agent header will be reduced and controlled by experimentation.

Set this policy to 'ForceEnabled' to force the reduced version of the User-Agent request header for all origins.

Set this policy to 'ForceDisabled' to always use the full (legacy) User-Agent header.

To learn more about the User-Agent string, read here:

https://go.microsoft.com/fwlink/?linkid=2186267

Policy options mapping:

* Default (0) = Reduced User Agent, or controlled by experimentation.

* ForceDisabled (1) = Full (legacy) User Agent.

* ForceEnabled (2) = Reduced User Agent.

Use the preceding information when configuring this policy.

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/UserAgentReduction
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Enable or disable the User-Agent Reduction
# Possible options:
#   Reduced User Agent, or controlled by experimentation. = 0
#   Full (legacy) User Agent. = 1
#   Reduced User Agent. = 2
Set-ItemProperty -Path $k -Name 'UserAgentReduction' -Value 0 -Type DWord

Disable

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

Revert to "Not configured"

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

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Enable or disable the User-Agent ReductionUserAgentReductionDrop-down listenumUserAgentReductionREG_DWORD
LabelValue
Reduced User Agent, or controlled by experimentation.REG_DWORD = 0
Full (legacy) User Agent.REG_DWORD = 1
Reduced User Agent.REG_DWORD = 2

Application

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

Official templates downloaded on November 12, 2026.