Open in the explorer

Automatically grant permission to these sites to connect to HID devices containing top-level collections with the given HID usage

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

Explanation

This setting allows you to list the URLs that specify which sites are automatically granted permission to access an HID device containing a top-level collection with the given HID usage.

Each item in the list requires both usages and urls fields for the policy to be valid.

* Each item in the usages field must have a usage_page and may have a usage field.

* Omitting the usage field creates a policy matching any device containing a top-level collection with a usage from the specified usage page.

* An item which has a usage field without a usage_page field is invalid and is ignored.

If you don't set this policy, then 'DefaultWebHidGuardSetting' (Control use of the WebHID API) applies, if it's set. If not, the user's personal setting applies.

For detailed information about valid URL patterns, see https://go.microsoft.com/fwlink/?linkid=2095322. * is not an accepted value for this policy.

URLs in this policy shouldn't conflict with those configured through 'WebHidBlockedForUrls' (Block the WebHID API on these sites). If they do, this policy takes precedence over 'WebHidBlockedForUrls'.

Example value:

[
{
"urls": [
"https://microsoft.com",
"https://chromium.org"
],
"usages": [
{
"usage": 5678,
"usage_page": 1234
}
]
}
]

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/WebHidAllowDevicesWithHidUsagesForUrls
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Automatically grant permission to these sites to connect to HID devices containing top-level collections with the given HID usage
Set-ItemProperty -Path $k -Name 'WebHidAllowDevicesWithHidUsagesForUrls' -Value '<value>' -Type String

Disable

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

Revert to "Not configured"

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

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Automatically grant permission to these sites to connect to HID devices containing top-level collections with the given HID usageWebHidAllowDevicesWithHidUsagesForUrlsText boxtextWebHidAllowDevicesWithHidUsagesForUrlsREG_SZ
Max length: 1000000

Application

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

Official templates downloaded on November 12, 2026.