Share via

UserAgentReduction

Enable or disable the User-Agent Reduction (deprecated)

DEPRECATED: This policy is deprecated. It is currently supported but will become obsolete in a future release.

Supported versions

  • On Windows and macOS since 99 or later

Description

The User-Agent HTTP request header has been reduced by default since Microsoft Edge version 119. To continue receiving detailed platform information, migrate to User-Agent Client Hints, which replace the deprecated detailed User-Agent header. For more information, visit: https://web.dev/articles/migrate-to-ua-ch

If you don't configure this policy or set it to Default, the User-Agent header will be reduced and controlled by experimentation.

Set this policy to 'ForceEnabled' to force the reduced version of the User-Agent request header for all origins.

Set this policy to 'ForceDisabled' to always use the full (legacy) User-Agent header.

To learn more about the User-Agent string, read here:

https://go.microsoft.com/fwlink/?linkid=2186267

Policy options mapping:

  • Default (0) = Reduced User Agent, or controlled by experimentation.

  • ForceDisabled (1) = Full (legacy) User Agent.

  • ForceEnabled (2) = Reduced User Agent.

Use the preceding information when configuring this policy.

Policy options mapping:

Use this information when configuring this policy.

  • Default (0) = Reduced User Agent, or controlled by experimentation.
  • ForceDisabled (1) = Full (legacy) User Agent.
  • ForceEnabled (2) = Reduced User Agent.

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

  • Integer

Windows information and settings

Group Policy (ADMX) info

  • GP unique name: UserAgentReduction
  • GP name: Enable or disable the User-Agent Reduction (deprecated)
  • GP path (Mandatory): Administrative Templates/Microsoft Edge
  • GP path (Recommended): N/A
  • GP ADMX file name: MSEdge.admx

Example value

Reduced User Agent, or controlled by experimentation.

Registry settings

  • Path (Mandatory): SOFTWARE\Policies\Microsoft\Edge
  • Path (Recommended): N/A
  • Value name: UserAgentReduction
  • Value type: REG_DWORD

Example registry value

0x00000000

Mac information and settings

  • Preference Key name: UserAgentReduction
  • Example value:
<integer>0</integer>

See also