Control use of the WebUSB API
Explanation
Set whether websites can access connected USB devices. You can completely block access or ask the user each time a website wants to get access to connected USB devices.
You can override this policy for specific URL patterns by using the 'WebUsbAskForUrls' (Allow WebUSB on specific sites) and 'WebUsbBlockedForUrls' (Block WebUSB on specific sites) policies.
If you don't configure this policy, sites can ask users whether they can access the connected USB devices ('AskWebUsb') by default, and users can change this setting.
Policy options mapping:
* BlockWebUsb (2) = Do not allow any site to request access to USB devices via the WebUSB API
* AskWebUsb (3) = Allow sites to ask the user to grant access to a connected USB device
Use the preceding information when configuring this policy.
Registry
HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\EdgeHKEY_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/DefaultWebUsbGuardSetting
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Control use of the WebUSB API
# Possible options:
# Do not allow any site to request access to USB devices via the WebUSB API = 2
# Allow sites to ask the user to grant access to a connected USB device = 3
Set-ItemProperty -Path $k -Name 'DefaultWebUsbGuardSetting' -Value 2 -Type DWordDisable
# Disable: msedge/DefaultWebUsbGuardSetting
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": msedge/DefaultWebUsbGuardSetting
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
Remove-ItemProperty -Path $k -Name 'DefaultWebUsbGuardSetting' -ErrorAction SilentlyContinueUser (HKCU)
Enable
Disable
Revert to "Not configured"
Options (1)
| Label | Control | Registry value | REG type | Constraints / details | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Control use of the WebUSB APIDefaultWebUsbGuardSetting | Drop-down listenum | DefaultWebUsbGuardSetting | REG_DWORD |
|
Application
Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.