Enable or disable the User-Agent Reduction (obsolete)
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\EdgeHKEY_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 DWordDisable
# 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 SilentlyContinueUser (HKCU)
Enable
Disable
Revert to "Not configured"
Options (1)
| Label | Control | Registry value | REG type | Constraints / details | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Enable or disable the User-Agent ReductionUserAgentReduction | Drop-down listenum | UserAgentReduction | REG_DWORD |
|
Application
Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.