Open in the explorer

Control use of the WebHID 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 100, Windows 7 or later
ADMX file
msedge.admx
Internal name
msedge/DefaultWebHidGuardSetting

Explanation

Setting the policy to 3 lets websites ask for access to HID devices. Setting the policy to 2 denies access to HID devices.

Leaving it unset lets websites ask for access, but users can change this setting.

This policy can be overridden for specific url patterns using the 'WebHidAskForUrls' (Allow the WebHID API on these sites) and 'WebHidBlockedForUrls' (Block the WebHID API on these sites) policies.

Policy options mapping:

* BlockWebHid (2) = Do not allow any site to request access to HID devices via the WebHID API

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

Disable

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

Revert to "Not configured"

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

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Control use of the WebHID APIDefaultWebHidGuardSettingDrop-down listenumDefaultWebHidGuardSettingREG_DWORD
LabelValue
Do not allow any site to request access to HID devices via the WebHID APIREG_DWORD = 2
Allow sites to ask the user to grant access to a HID deviceREG_DWORD = 3

Application

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

Official templates downloaded on November 12, 2026.