Controls whether unload event handlers can be disabled.
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\WebView2HKEY_CURRENT_USER\Software\Policies\Microsoft\Edge\WebView2- Value name
ForcePermissionPolicyUnloadDefaultEnabled
| State | Value written |
|---|---|
| Enabled | REG_DWORD = 1 |
| Disabled | REG_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 DWordDisable
# 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 DWordRevert to "Not configured"
# Revert to "Not configured": msedgewebview2/ForcePermissionPolicyUnloadDefaultEnabled
$k = 'HKLM:\Software\Policies\Microsoft\Edge\WebView2'
Remove-ItemProperty -Path $k -Name 'ForcePermissionPolicyUnloadDefaultEnabled' -ErrorAction SilentlyContinueUser (HKCU)
Enable
Disable
Revert to "Not configured"
Application
Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.