Open in the explorer

Allow Back/Forward Cache for WebSockets (deprecated)

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

Explanation

DEPRECATED: This policy is deprecated. It is currently supported but will become obsolete in a future release.

This policy controls whether active WebSocket connections are disconnected when a page enters back/forward cache. Active WebSocket connections previously prevented a page from being stored in back/forward cache, but Microsoft Edge has changed this behavior to disconnect the WebSockets instead, allowing the page to be cached and restoring it in a disconnected state.

If this policy is set to Enabled or left unset, WebSockets are disconnected when a page enters back/forward cache.

If this policy is set to Disabled, WebSockets will not be disconnected when a page enters back/forward cache. Since back/forward cache does not support active WebSockets, this means pages with active WebSockets will not be cached.

This policy is deprecated starting in Microsoft Edge version 157 because it was intended to be temporary. It will be removed starting in Microsoft Edge version 167. There is no replacement policy; organizations should stop configuring it before then.

Registry

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

Disable

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

Revert to "Not configured"

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