Edit

Share via

ScreenCaptureWithoutGestureAllowedForOrigins

  • Article

Allow screen capture without prior user gesture

Supported versions

  • On Windows and macOS since 123 or later

Description

For security reasons, the getDisplayMedia() web API requires a prior user gesture ("transient activation") to be called or the API will fail.

When this policy is configured, admins can specify origins on which this API can be called without prior user gesture.

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

If this policy is not configured, all origins require a prior user gesture to call this API.

Supported features

  • Can be mandatory: Yes
  • Can be recommended: No
  • Dynamic Policy Refresh: Yes
  • Per Profile: Yes
  • Applies to a profile that is signed in with a Microsoft account: No

Data type

  • List of strings

Windows information and settings

Group Policy (ADMX) info

  • GP unique name: ScreenCaptureWithoutGestureAllowedForOrigins
  • GP name: Allow screen capture without prior user gesture
  • GP path (Mandatory): Administrative Templates/Microsoft Edge
  • GP path (Recommended): N/A
  • GP ADMX file name: MSEdge.admx

Example value

https://www.example.com

[*.]example.edu

Registry settings

  • Path (Mandatory): SOFTWARE\Policies\Microsoft\Edge\ScreenCaptureWithoutGestureAllowedForOrigins
  • Path (Recommended): N/A
  • Value name: 1, 2, 3, ...
  • Value type: List of REG_SZ

Example registry value

SOFTWARE\Policies\Microsoft\Edge\ScreenCaptureWithoutGestureAllowedForOrigins\1 =

https://www.example.com

SOFTWARE\Policies\Microsoft\Edge\ScreenCaptureWithoutGestureAllowedForOrigins\2 =

[*.]example.edu

Mac information and settings

  • Preference Key name: ScreenCaptureWithoutGestureAllowedForOrigins
  • Example value:
<array>
  <string>https://www.example.com</string>
  <string>[*.]example.edu</string>
</array>

See also