Configure per-application WebView2 downgrade version
Explanation
This policy lets you specify the exact 4-part version of the WebView2 Runtime that specific applications should use in enterprise downgrade scenarios.
Configure the policy by setting the value name to the Application User Model ID or the executable file name (for example, ms-teams.exe). Set the value to the target full version string using the 4-part numeric format (for example, 151.0.2178.0).
Major-only values (for example, 151), wildcard values (for example, 151.*), and values that are not exact 4-part numeric versions are not supported.
Enterprise downgrade supports target versions from N-1 through N-4 relative to the current Evergreen WebView2 Runtime major version.
The WebView2 loader resolves the runtime installation directory only when a folder that exactly matches the configured full version exists (for example, 151.0.2178.0 must match 151.0.2178.0 exactly). If no exact matching folder is found, the policy has no effect and the runtime defaults to the BrowserExecutableFolder policy or the Evergreen runtime (the default auto-updating runtime).
Example value:
Name: ms-teams.exe, Value: 151.0.2178.0
Name: olk.exe, Value: 152.0.2164.0
Registry
HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2HKEY_CURRENT_USER\Software\Policies\Microsoft\Edge\WebView2- 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: msedgewebview2/DowngradeVersion
$k = 'HKLM:\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Set value name to the Application User Model ID or the executable file name. Set value to the target full 4-part version string (for example, 151.0.2178.0).
# Non-additive list: existing values of the key are cleared first
if (Test-Path -Path $k) { (Get-Item -Path $k).Property | ForEach-Object { Remove-ItemProperty -Path $k -Name ([WildcardPattern]::Escape($_)) -ErrorAction SilentlyContinue } }
$items = @{
'<name1>' = '<value1>'
'<name2>' = '<value2>'
} # Replace the values with your own
$items.GetEnumerator() | ForEach-Object { Set-ItemProperty -Path $k -Name $_.Key -Value $_.Value -Type String }Disable
# Disable: msedgewebview2/DowngradeVersion
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": msedgewebview2/DowngradeVersion
$k = 'HKLM:\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion'
Remove-Item -Path $k -Recurse -Force -ErrorAction SilentlyContinueUser (HKCU)
Enable
Disable
Revert to "Not configured"
Options (1)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Set value name to the Application User Model ID or the executable file name. Set value to the target full 4-part version string (for example, 151.0.2178.0).DowngradeVersionDesc | List (table)list | Software\Policies\Microsoft\Edge\WebView2\DowngradeVersionName = value pairs | REG_SZ (values under the key) |
Application
Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.