Open in the explorer

Control use of the Web Bluetooth API

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

Explanation

Control whether websites can access nearby Bluetooth devices. You can completely block access or require the site to ask the user each time it wants to access a Bluetooth device.

If you don't configure this policy, the default value ('AskWebBluetooth', meaning users are asked each time) is used and users can change it.

Policy options mapping:

* BlockWebBluetooth (2) = Do not allow any site to request access to Bluetooth devices via the Web Bluetooth API

* AskWebBluetooth (3) = Allow sites to ask the user to grant access to a nearby Bluetooth device

Use the preceding information when configuring this policy.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge
HKEY_CURRENT_USER\Software\Policies\Microsoft\Edge
Value name
not defined in the ADMX

Enable / disable values: not defined in the ADMX (see the options below).

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/DefaultWebBluetoothGuardSetting
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Control use of the Web Bluetooth API
# Possible options:
#   Do not allow any site to request access to Bluetooth devices via the Web Bluetooth API = 2
#   Allow sites to ask the user to grant access to a nearby Bluetooth device = 3
Set-ItemProperty -Path $k -Name 'DefaultWebBluetoothGuardSetting' -Value 2 -Type DWord

Disable

# Disable: msedge/DefaultWebBluetoothGuardSetting
# No value is written in the "Disabled" state (nothing defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": msedge/DefaultWebBluetoothGuardSetting
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
Remove-ItemProperty -Path $k -Name 'DefaultWebBluetoothGuardSetting' -ErrorAction SilentlyContinue

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Control use of the Web Bluetooth APIDefaultWebBluetoothGuardSettingDrop-down listenumDefaultWebBluetoothGuardSettingREG_DWORD
LabelValue
Do not allow any site to request access to Bluetooth devices via the Web Bluetooth APIREG_DWORD = 2
Allow sites to ask the user to grant access to a nearby Bluetooth deviceREG_DWORD = 3

Application

Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates

Official templates downloaded on November 12, 2026.