Open in the explorer

Control the User-Agent Client Hints GREASE Update 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 102-133, Windows 7 or later
ADMX file
msedge.admx
Internal name
msedge/UserAgentClientHintsGREASEUpdateEnabled

Explanation

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

The User-Agent GREASE specification recommends the inclusion of more GREASE characters beyond the current semicolon and space, and recommends that the arbitrary version number is varied over time.

When enabled, the User-Agent Client Hints GREASE Update feature aligns the User-Agent GREASE algorithm with the latest version from the specification. The updated specification can break some websites that restrict the characters that requests may contain. For more information, see the following specification: https://wicg.github.io/ua-client-hints/#grease

If this policy is enabled or not configured, the User-Agent GREASE algorithm from the specification is used. If the policy is disabled, the prior User-Agent GREASE algorithm is used.

This policy will be obsolete after version 133 because the updated GREASE algorithm is on by default since Microsoft Edge version 102.

Registry

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

Disable

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

Revert to "Not configured"

# Revert to "Not configured": msedge/UserAgentClientHintsGREASEUpdateEnabled
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
Remove-ItemProperty -Path $k -Name 'UserAgentClientHintsGREASEUpdateEnabled' -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.