Configure per-application WebView2 downgrade version
Jump to overview

Policy overview

Key metadata and intent for this policy.

Category
Microsoft Edge WebView2 > Loader Override Settings
Supported on
Microsoft Edge version 149, Windows 7 or later

Supported OS tags: Windows7

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

Internal name
DowngradeVersion
Policy ID
8213f33f7d76
Elements
1

Registry values

How enabled and disabled states update the registry.

No explicit registry values are set for enabled or disabled states.

Policy elements

Inputs and configuration options exposed by this policy.

ScopeElementTypeRegistry mappingConstraints & behaviorCopy
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).
ID DowngradeVersionDesc
list
Path
Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion
Value name
User-defined names
Type
REG_SZ
List: explicit value
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).
Both · Type list
Registry mapping
Path
Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion
Value name
User-defined names
Type
REG_SZ
Details
List: explicit value