Open in the explorer

Register protocol handlers

Type
Computer and user
GPO path
Computer Configuration › Policies › Administrative Templates › Microsoft Edge - Default Settings (users can override) › Content settings User Configuration › Policies › Administrative Templates › Microsoft Edge - Default Settings (users can override) › Content settings
Supported on
Microsoft Edge version 77, Windows 7 or later
ADMX file
msedge.admx
Internal name
msedge/RegisteredProtocolHandlers_recommended

Explanation

Set this policy (recommended only) to register a list of protocol handlers. This list is merged with ones registered by the user and both are available to use.

To register a protocol handler:

- Set the protocol property to the scheme (for example, "mailto")
- Set the URL property to the URL property of the application that handlers the scheme specified in the "protocol" field. The pattern can include a "%s" placeholder, which the handled URL replaces.

Users can't remove a protocol handler registered by this policy. However, they can install a new default protocol handler to override the existing protocol handlers.

In the examples in this section, the URL points to the Outlook on the Web (OWA) endpoint used in Exchange Online. If you're targeting Exchange Server (on-premises), use the following URL and replace mail.contoso.com with your organization's OWA endpoint:

https://mail.contoso.com/?path=/mail/action/compose&mailtouri=%s

Example value:

[
{
"default": true,
"protocol": "mailto",
"url": "https://outlook.office.com/mail/deeplink/compose?to=%s"
}
]

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\Recommended
HKEY_CURRENT_USER\Software\Policies\Microsoft\Edge\Recommended
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/RegisteredProtocolHandlers_recommended
$k = 'HKLM:\Software\Policies\Microsoft\Edge\Recommended'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Register protocol handlers
Set-ItemProperty -Path $k -Name 'RegisteredProtocolHandlers' -Value '<value>' -Type String

Disable

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

Revert to "Not configured"

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

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Register protocol handlersRegisteredProtocolHandlersText boxtextRegisteredProtocolHandlersREG_SZ
Max length: 1000000

Application

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

Official templates downloaded on November 12, 2026.