Open in the explorer

Forces Microsoft Edge to use its built-in WNS push client to connect to the Windows Push Notification Service.

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 118, Windows 7 or later
ADMX file
msedge.admx
Internal name
msedge/ForceBuiltInPushMessagingClient

Explanation

In some environments, the Windows OS client can't connect to the Windows Push Notification Service (WNS). For these environments, you can use the Microsoft Edge built-in WNS push client, which can connect successfully.

If enabled, Microsoft Edge uses its built-in WNS push client to connect to WNS.

If disabled or not configured, Microsoft Edge uses the Windows OS client to connect to the Windows Push Notification Service. This is the default setting.

Registry

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

Disable

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

Revert to "Not configured"

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