Microsoft Edge Update › Microsoft Edge WebView2 Runtime
Update policy override
Supported on Microsoft Edge Update 1.3.127.1 and later
What it does
Lets you specify whether or not automatic updates are enabled for the WebView2 Runtime. The WebView2 Runtime is a component used by applications to display web content. Automatic updates are enabled by default. Disabling automatic updates for the WebView2 Runtime might cause compatibility issues with applications that depend on this component. If you enable this policy, Microsoft Edge Update handles the WebView2 Runtime updates according to how you configure the following options: - Always allow updates (1): Updates are automatically downloaded and applied - Updates disabled (0): Updates are never downloaded or applied If you don't enable this policy, updates are automatically downloaded and applied.
What it writes
- Hive
- HKEY_LOCAL_MACHINE
- Registry key
Software\Policies\Microsoft\EdgeUpdate
Options
| Option | Type | Registry value | Allowed values |
|---|---|---|---|
| Update PolicyRequiredDefault: Always allow updates (recommended) | Drop-down list | Update{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5} |
|
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\EdgeUpdate]
"Update{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}"=dword:00000001
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: Update policy override
# Name: Pol_UpdatePolicyMicrosoftEdgeWebView
# Scope: Machine
# State: Enabled
# Source: msedgeupdate.admx
Set-RegistryValue -Path 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\EdgeUpdate' -Name 'Update{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}' -PropertyType 'DWord' -Value 1
- 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.
ADMX profile candidate (OMA-URI)
./Device/Vendor/MSFT/Policy/Config/ADMX_msedgeupdate/Pol_UpdatePolicyMicrosoftEdgeWebViewADMX SyncML candidate
<SyncML xmlns="SYNCML:SYNCML1.2">
<SyncBody>
<Replace>
<CmdID>1</CmdID>
<Item>
<Meta>
<Format>chr</Format>
<Type>text/plain</Type>
</Meta>
<Target>
<LocURI>./Device/Vendor/MSFT/Policy/Config/ADMX_msedgeupdate/Pol_UpdatePolicyMicrosoftEdgeWebView</LocURI>
</Target>
<Data><enabled/>
<data id="Part_UpdatePolicy" value="0"/></Data>
</Item>
</Replace>
<Final/>
</SyncBody>
</SyncML>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: Update policy override
# Name: Pol_UpdatePolicyMicrosoftEdgeWebView
# Scope: Machine
# State: Enabled
# Source: msedgeupdate.admx
$isMatch = Test-RegistryValueEquals -Path 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\EdgeUpdate' -Name 'Update{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}' -Kind 'DWord' -Expected 1
if (-not $isMatch) {
$reasons.Add('Value mismatch: HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\EdgeUpdate\Update{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}') | 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: Update policy override
# Name: Pol_UpdatePolicyMicrosoftEdgeWebView
# Scope: Machine
# State: Enabled
# Source: msedgeupdate.admx
Set-RegistryValue -Path 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\EdgeUpdate' -Name 'Update{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}' -PropertyType 'DWord' -Value 1
History 37 retained releases
- 150.0.4078.8016 Jul 2026
- Already present in the first release ChangeIntel keeps.
36 later releases left it unchanged.
Template
- Internal name
Pol_UpdatePolicyMicrosoftEdgeWebView- Namespace
Microsoft.Policies.Update- Template file
msedgeupdate.admx- Release
- Microsoft Edge 155.0.4283.62 · file set
0a733b0040dbbf02…
Definition, editor controls and support
Definition
<policy class="Machine" displayName="$(string.Pol_UpdatePolicy)" explainText="$(string.Explain_WebView_AutoUpdate)" key="Software\Policies\Microsoft\EdgeUpdate" name="Pol_UpdatePolicyMicrosoftEdgeWebView" presentation="$(presentation.Pol_UpdatePolicy)" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<parentCategory ref="Microsoft.Policies.Update:Cat_WebView" />
<supportedOn ref="Microsoft.Policies.Update:Sup_EdgeUpdate1_3_127_1" />
<elements>
<enum id="Part_UpdatePolicy" required="true" valueName="Update{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}">
<item displayName="$(string.Name_UpdatesEnabled)">
<value>
<decimal value="1" />
</value>
</item>
<item displayName="$(string.Name_UpdatesDisabled)">
<value>
<decimal value="0" />
</value>
</item>
</enum>
</elements>
</policy>Editor controls
<presentation id="Pol_UpdatePolicy" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<dropdownList defaultItem="0" refId="Part_UpdatePolicy">Update Policy</dropdownList>
</presentation>Supported platforms and category
Microsoft.Policies.Update:category:Cat_EdgeUpdate
<category displayName="$(string.Cat_GoogleUpdate)" explainText="$(string.Explain_GoogleUpdate)" name="Cat_EdgeUpdate" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
</category>
Microsoft.Policies.Update:category:Cat_WebView
<category displayName="$(string.Cat_WebView)" explainText="$(string.Explain_WebView)" name="Cat_WebView" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<parentCategory ref="Microsoft.Policies.Update:Cat_EdgeUpdate" />
</category>
Microsoft.Policies.Update:definition:Sup_EdgeUpdate1_3_127_1
<definition displayName="$(string.Sup_EdgeUpdate1_3_127_1)" name="Sup_EdgeUpdate1_3_127_1" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
Microsoft.Policies.Update:category:Cat_EdgeUpdate
<category displayName="$(string.Cat_GoogleUpdate)" explainText="$(string.Explain_GoogleUpdate)" name="Cat_EdgeUpdate" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
</category>
<strings><string id="Microsoft.Policies.Update:Cat_GoogleUpdate">Microsoft Edge Update</string><string id="Microsoft.Policies.Update:Explain_GoogleUpdate">Policies to control the installation and updating of Microsoft Edge using Microsoft Edge Update.</string></strings>
Microsoft.Policies.Update:category:Cat_WebView
<category displayName="$(string.Cat_WebView)" explainText="$(string.Explain_WebView)" name="Cat_WebView" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<parentCategory ref="Microsoft.Policies.Update:Cat_EdgeUpdate" />
</category>
<strings><string id="Microsoft.Policies.Update:Cat_WebView">Microsoft Edge WebView2 Runtime</string><string id="Microsoft.Policies.Update:Explain_WebView">Specfies policies for the WebView2 Runtime.</string></strings>
Microsoft.Policies.Update:definition:Sup_EdgeUpdate1_3_127_1
<definition displayName="$(string.Sup_EdgeUpdate1_3_127_1)" name="Sup_EdgeUpdate1_3_127_1" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
<strings><string id="Microsoft.Policies.Update:Sup_EdgeUpdate1_3_127_1">Microsoft Edge Update 1.3.127.1 and later</string></strings>