Allow file or directory picker APIs to be called without prior user gesture
Explanation
For security reasons, the showOpenFilePicker(), showSaveFilePicker(), and showDirectoryPicker() web APIs require a prior user gesture ("transient activation") to be called; else, they fail.
If you enable this policy, admins can specify origins on which these APIs can be called without prior user gesture.
For detailed information on valid URL patterns, see https://go.microsoft.com/fwlink/?linkid=2095322. * isn't an accepted value for this policy.
If you disable or don't configure this policy, all origins will require a prior user gesture to call these APIs.
Example value:
https://www.example.com
[*.]example.edu
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/FileOrDirectoryPickerWithoutGestureAllowedForOrigins
$k = 'HKLM:\Software\Policies\Microsoft\Edge\FileOrDirectoryPickerWithoutGestureAllowedForOrigins'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Allow file or directory picker APIs to be called without prior user gesture
# Non-additive list: existing values of the key are cleared first
if (Test-Path -Path $k) { (Get-Item -Path $k).Property | ForEach-Object { Remove-ItemProperty -Path $k -Name ([WildcardPattern]::Escape($_)) -ErrorAction SilentlyContinue } }
$values = @('<value1>', '<value2>') # Replace the values with your own
$i = 1
foreach ($v in $values) { Set-ItemProperty -Path $k -Name ('' + $i) -Value $v -Type String; $i++ }Disable
# Disable: msedge/FileOrDirectoryPickerWithoutGestureAllowedForOrigins
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": msedge/FileOrDirectoryPickerWithoutGestureAllowedForOrigins
$k = 'HKLM:\Software\Policies\Microsoft\Edge\FileOrDirectoryPickerWithoutGestureAllowedForOrigins'
Remove-Item -Path $k -Recurse -Force -ErrorAction SilentlyContinueUser (HKCU)
Enable
Disable
Revert to "Not configured"
Options (1)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Allow file or directory picker APIs to be called without prior user gestureFileOrDirectoryPickerWithoutGestureAllowedForOriginsDesc | List (table)list | Software\Policies\Microsoft\Edge\FileOrDirectoryPickerWithoutGestureAllowedForOriginsValues named “” + number | REG_SZ (values under the key) |
Application
Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.