Open in the explorer

Controls whether unload event handlers can be disabled.

Type
Computer and user
GPO path
Computer Configuration › Policies › Administrative Templates › Microsoft Edge WebView2 User Configuration › Policies › Administrative Templates › Microsoft Edge WebView2
Supported on
Microsoft Edge version 118, Windows 7 or later
ADMX file
msedgewebview2.admx
Internal name
msedgewebview2/ForcePermissionPolicyUnloadDefaultEnabled

Explanation

The unload event handlers are being deprecated. Whether they fire depends on the unload Permissions-Policy.
Currently, the policy allows them by default. In the future, they will be disallowed by default, and sites must explicitly enable them using Permissions-Policy headers.
This enterprise policy can be used to opt out of this gradual deprecation by forcing the default to remain enabled.

Pages might depend on unload event handlers to save data or to signal the end of a user session to the server.
This dependency isn't recommended because it's unreliable and impacts performance by blocking use of BackForwardCache.
Recommended alternatives exist, but the unload event has been used for a long time. Some applications might still rely on them.

If you disable this policy or don't configure it, unload event handlers are gradually deprecated in-line with the deprecation rollout, and sites that don't set Permissions-Policy header stop firing `unload` events.

If you enable this policy, the unload event handlers continue to work by default.

Registry

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

Disable

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

Revert to "Not configured"

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