Configure per-application WebView2 downgrade version

Computer and userIntune-readyDowngradeVersion

Supported on Microsoft Edge version 149, Windows 7 or later

155.0.4283.62

What it does

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

What it writes

Hive: HKEY_LOCAL_MACHINE or HKEY_CURRENT_USER
Registry key: Software\Policies\Microsoft\Edge\WebView2

Options

Option	Type	Registry value	Allowed values
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).	List of values	`Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion`	Name and value pairs

Configure and deploy

Choose a state and the option values; the output below is generated from the template for exactly that.

Enabled · Computer · template defaults

Registry file (.reg)

Windows Registry Editor Version 5.00

[-HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion]

PowerShell

$ErrorActionPreference = 'Stop'

function Set-RegistryValue {
    param(
        [Parameter(Mandatory = $true)][string] $Path,
        [Parameter(Mandatory = $true)][string] $Name,
        [Parameter(Mandatory = $true)][string] $PropertyType,
        [Parameter(Mandatory = $true)][object] $Value
    )

    if (-not (Test-Path -LiteralPath $Path)) {
        New-Item -Path $Path -Force | Out-Null
    }

    New-ItemProperty -LiteralPath $Path -Name $Name -PropertyType $PropertyType -Value $Value -Force | Out-Null
}

function Remove-RegistryValue {
    param(
        [Parameter(Mandatory = $true)][string] $Path,
        [Parameter(Mandatory = $true)][string] $Name
    )

    if (Test-Path -LiteralPath $Path) {
        Remove-ItemProperty -LiteralPath $Path -Name $Name -Force -ErrorAction SilentlyContinue
    }
}

function Clear-RegistryKeyValues {
    param(
        [Parameter(Mandatory = $true)][string] $Path
    )

    if (-not (Test-Path -LiteralPath $Path)) {
        return
    }

    foreach ($propertyName in (Get-Item -LiteralPath $Path).Property) {
        Remove-ItemProperty -LiteralPath $Path -Name $propertyName -Force -ErrorAction SilentlyContinue
    }
}

# Policy: Configure per-application WebView2 downgrade version
# Name: DowngradeVersion
# Scope: Machine
# State: Enabled
# Source: msedgewebview2.admx

Clear-RegistryKeyValues -Path 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion'

The OMA-URI is an inferred ADMX-backed Policy CSP candidate derived from the source ADMX file name and policy name.
Some Microsoft policies use built-in Policy CSP pages whose area names don't match the ADMX file name, so verify the candidate against Microsoft Learn before deployment.
The generated payload is incomplete because one or more ADMX element values were not supplied: DowngradeVersionDesc

ADMX profile candidate (OMA-URI)

./Device/Vendor/MSFT/Policy/Config/ADMX_msedgewebview2/DowngradeVersion

Intune remediation scripts

Detection

$ErrorActionPreference = 'Stop'
$reasons = [System.Collections.Generic.List[string]]::new()

function Test-RegistryValueExists {
    param(
        [Parameter(Mandatory = $true)][string] $Path,
        [Parameter(Mandatory = $true)][string] $Name
    )

    if (-not (Test-Path -LiteralPath $Path)) {
        return $false
    }

    return $null -ne (Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction SilentlyContinue)
}

function Test-RegistryValueEquals {
    param(
        [Parameter(Mandatory = $true)][string] $Path,
        [Parameter(Mandatory = $true)][string] $Name,
        [Parameter(Mandatory = $true)][string] $Kind,
        [Parameter(Mandatory = $true)][object] $Expected
    )

    if (-not (Test-Path -LiteralPath $Path)) {
        return $false
    }

    $valueObject = Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction SilentlyContinue
    if ($null -eq $valueObject) {
        return $false
    }

    $actual = $valueObject.$Name
    switch ($Kind) {
        'String' { return [string]$actual -ceq [string]$Expected }
        'ExpandString' { return [string]$actual -ceq [string]$Expected }
        'DWord' { return [uint32]$actual -eq [uint32]$Expected }
        'QWord' { return [uint64]$actual -eq [uint64]$Expected }
        'MultiString' {
            $actualArray = @($actual)
            $expectedArray = @($Expected)
            if ($actualArray.Count -ne $expectedArray.Count) { return $false }
            for ($index = 0; $index -lt $actualArray.Count; $index++) {
                if ([string]$actualArray[$index] -cne [string]$expectedArray[$index]) { return $false }
            }
            return $true
        }
        'Binary' {
            $actualArray = [byte[]]$actual
            $expectedArray = [byte[]]$Expected
            if ($actualArray.Length -ne $expectedArray.Length) { return $false }
            for ($index = 0; $index -lt $actualArray.Length; $index++) {
                if ($actualArray[$index] -ne $expectedArray[$index]) { return $false }
            }
            return $true
        }
        default { return [string]$actual -ceq [string]$Expected }
    }
}

# Policy: Configure per-application WebView2 downgrade version
# Name: DowngradeVersion
# Scope: Machine
# State: Enabled
# Source: msedgewebview2.admx

$keyPath = 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion'
if (Test-Path -LiteralPath $keyPath) {
    $propertyNames = (Get-Item -LiteralPath $keyPath).Property
    if ($propertyNames.Count -gt 0) {
        $reasons.Add('Key should be empty: HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion') | Out-Null
    }
}

if ($reasons.Count -eq 0) {
    Write-Output 'Compliant'
    exit 0
}

$reasons | ForEach-Object { Write-Output $_ }
exit 1

Remediation

$ErrorActionPreference = 'Stop'

function Set-RegistryValue {
    param(
        [Parameter(Mandatory = $true)][string] $Path,
        [Parameter(Mandatory = $true)][string] $Name,
        [Parameter(Mandatory = $true)][string] $PropertyType,
        [Parameter(Mandatory = $true)][object] $Value
    )

    if (-not (Test-Path -LiteralPath $Path)) {
        New-Item -Path $Path -Force | Out-Null
    }

    New-ItemProperty -LiteralPath $Path -Name $Name -PropertyType $PropertyType -Value $Value -Force | Out-Null
}

function Remove-RegistryValue {
    param(
        [Parameter(Mandatory = $true)][string] $Path,
        [Parameter(Mandatory = $true)][string] $Name
    )

    if (Test-Path -LiteralPath $Path) {
        Remove-ItemProperty -LiteralPath $Path -Name $Name -Force -ErrorAction SilentlyContinue
    }
}

function Clear-RegistryKeyValues {
    param(
        [Parameter(Mandatory = $true)][string] $Path
    )

    if (-not (Test-Path -LiteralPath $Path)) {
        return
    }

    foreach ($propertyName in (Get-Item -LiteralPath $Path).Property) {
        Remove-ItemProperty -LiteralPath $Path -Name $propertyName -Force -ErrorAction SilentlyContinue
    }
}

# Policy: Configure per-application WebView2 downgrade version
# Name: DowngradeVersion
# Scope: Machine
# State: Enabled
# Source: msedgewebview2.admx

Clear-RegistryKeyValues -Path 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion'

History 37 retained releases

154.0.4258.3724 Sep 2026
- Description … the Application User Model ID or the executable fi…[added: ms-]teams.exe). Set the value to the target full version string using the 4-…[added: Enterprise downgrade supports target versions from N-1 throug…]The WebView2 loader resolves the runtime installation directo…[added: ms-]teams.exe, Value: 151.0.2178.0 Name: o~~[removed: utloo]~~[added: l]k.exe, Value: 152.0.2164.0
  Whole description, marked
  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, [added: 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. [added: 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: [added: ms-]teams.exe, Value: 151.0.2178.0 Name: o~~[removed: utloo]~~[added: l]k.exe, Value: 152.0.2164.0
152.0.4191.5328 Aug 2026
- Description This policy lets you specify the ~~[removed: major]~~[added: exact 4-part] version of the WebView2 Runtime that specif…~~[removed: major]~~[added: full] version ~~[removed: number]~~[added: string] using ~~[removed: digits only]~~[added: the 4-part numeric format] (for example, ~~[removed: 145). Full version strings ]~~[added: 151.0.2178.0). Major-only values ](for example, …
  Whole description, marked
  This policy lets you specify the ~~[removed: major]~~[added: 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, teams.exe). Set the value to the target ~~[removed: major]~~[added: full] version ~~[removed: number]~~[added: string] using ~~[removed: digits only]~~[added: the 4-part numeric format] (for example, ~~[removed: 145). Full version strings ]~~[added: 151.0.2178.0). Major-only values ](for example, ~~[removed: 145.0.1234.56),]~~[added: 151),] wildcard values (for example, 1~~[removed: 45]~~[added: 51].*), and values that ~~[removed: contain non-digit characters or separators]~~[added: are not exact 4-part numeric versions] are not supported. The WebView2 loader ~~[removed: scans]~~[added: resolves] the runtime installation directory ~~[removed: for an already-installed]~~[added: only when a] folder that [added: exactly ]matches the ~~[removed: specified major]~~[added: configured full] version [added: exists ](for example, ~~[removed: 145 matches 145.0.1234.56).]~~[added: 151.0.2178.0 must match 151.0.2178.0 exactly).] If no [added: 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: teams.exe, Value: ~~[removed: 145]~~[added: 151.0.2178.0] Name: outlook.exe, Value: ~~[removed: 146]~~[added: 152.0.2164.0]
- Option “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).” Set value name to the Application User Model ID or the executable file name. Set value to the target ~~[removed: major]~~[added: full 4-part] version ~~[removed: number (digits only, e.g. 145).]~~[added: string (for example, 151.0.2178.0).]
- Editor controls or their defaults changed.
151.0.4129.5931 Jul 2026
- Added in this release.

25 later releases left it unchanged.

Template

Internal name: DowngradeVersion
Namespace: Microsoft.Policies.WebView2
Template file: msedgewebview2.admx
Release: Microsoft Edge 155.0.4283.62 · file set 0a733b0040dbbf02…

Definition, editor controls and support

Definition

<policy class="Both" displayName="$(string.DowngradeVersion)" explainText="$(string.DowngradeVersion_Explain)" key="Software\Policies\Microsoft\Edge\WebView2" name="DowngradeVersion" presentation="$(presentation.DowngradeVersion)" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
      <parentCategory ref="Microsoft.Policies.WebView2:WebView2LoaderOverrideSettings" />
      <supportedOn ref="Microsoft.Policies.WebView2:SUPPORTED_WIN7_V149" />
      <elements>
        <list explicitValue="true" id="DowngradeVersionDesc" key="Software\Policies\Microsoft\Edge\WebView2\DowngradeVersion" />
      </elements>
    </policy>

Editor controls

<presentation id="DowngradeVersion" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions"><listBox refId="DowngradeVersionDesc">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).</listBox></presentation>

Supported platforms and category

Microsoft.Policies.WebView2:category:WebView2LoaderOverrideSettings
<category displayName="$(string.WebView2LoaderOverrideSettings_group)" name="WebView2LoaderOverrideSettings" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
      <parentCategory ref="Microsoft.Policies.WebView2:microsoft_edge_webview2" />
    </category>
Microsoft.Policies.WebView2:category:microsoft_edge_webview2
<category displayName="$(string.microsoft_edge_webview2)" name="microsoft_edge_webview2" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
Microsoft.Policies.WebView2:definition:SUPPORTED_WIN7_V149
<definition displayName="$(string.SUPPORTED_WIN7_V149)" name="SUPPORTED_WIN7_V149" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
Microsoft.Policies.WebView2:category:WebView2LoaderOverrideSettings
<category displayName="$(string.WebView2LoaderOverrideSettings_group)" name="WebView2LoaderOverrideSettings" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
      <parentCategory ref="Microsoft.Policies.WebView2:microsoft_edge_webview2" />
    </category>
<strings><string id="Microsoft.Policies.WebView2:WebView2LoaderOverrideSettings_group">Loader Override Settings</string></strings>
Microsoft.Policies.WebView2:category:microsoft_edge_webview2
<category displayName="$(string.microsoft_edge_webview2)" name="microsoft_edge_webview2" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
<strings><string id="Microsoft.Policies.WebView2:microsoft_edge_webview2">Microsoft Edge WebView2</string></strings>
Microsoft.Policies.WebView2:definition:SUPPORTED_WIN7_V149
<definition displayName="$(string.SUPPORTED_WIN7_V149)" name="SUPPORTED_WIN7_V149" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
<strings><string id="Microsoft.Policies.WebView2:SUPPORTED_WIN7_V149">Microsoft Edge version 149, Windows 7 or later</string></strings>