Open in the explorer

Enable the User-Agent Client Hints feature (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 86-93, Windows 7 or later
ADMX file
msedge.admx
Internal name
msedge/UserAgentClientHintsEnabled

Explanation

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

This policy is obsolete because it was intended for short-term adaptation purposes only. It doesn't work in Microsoft Edge after version 93.

When enabled the User-Agent Client Hints feature sends granular request headers that provide information about the user browser (for example, the browser version) and environment (for example, the system architecture).

This is an additive feature, but the new headers may break some websites that restrict the characters that requests may contain.

If you enable or don't configure this policy, the User-Agent Client Hints feature is enabled. If you disable this policy, this feature is unavailable.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge
HKEY_CURRENT_USER\Software\Policies\Microsoft\Edge
Value name
UserAgentClientHintsEnabled
StateValue written
EnabledREG_DWORD = 1
DisabledREG_DWORD = 0

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/UserAgentClientHintsEnabled
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'UserAgentClientHintsEnabled' -Value 1 -Type DWord

Disable

# Disable: msedge/UserAgentClientHintsEnabled
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'UserAgentClientHintsEnabled' -Value 0 -Type DWord

Revert to "Not configured"

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

User (HKCU)

Enable

Disable

Revert to "Not configured"

Application

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

Official templates downloaded on November 12, 2026.