Open in the explorer

Register protocol handlers

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

Explanation

Setting the policy (as recommended only) lets you register a list of protocol handlers, which merge with the ones that the user registers, putting both sets in use. Set the property "protocol" to the scheme, such as "mailto", and set the property "URL" to the URL pattern of the application that handles 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 policy. However, by installing a new default handler, they can change the protocol handlers installed by policy.
See https://chromeenterprise.google/policies/?policy=RegisteredProtocolHandlers for more information about schema and formatting.

Example value:

[
{
"default": true,
"protocol": "mailto",
"url": "https://mail.google.com/mail/?extsrc=mailto&url=%s"
}
]

Registry

HKEY_LOCAL_MACHINE\Software\Policies\BraveSoftware\Brave\Recommended
HKEY_CURRENT_USER\Software\Policies\BraveSoftware\Brave\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: brave/RegisteredProtocolHandlers_recommended
$k = 'HKLM:\Software\Policies\BraveSoftware\Brave\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: brave/RegisteredProtocolHandlers_recommended
# No value is written in the "Disabled" state (nothing defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": brave/RegisteredProtocolHandlers_recommended
$k = 'HKLM:\Software\Policies\BraveSoftware\Brave\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

Brave (Brave Software) — November 2026 templates

Official templates downloaded on November 12, 2026.