Open in the explorer

Configure list of force-installed Web Apps

Type
Computer and user
GPO path
Computer Configuration › Policies › Administrative Templates › Brave Software › Brave User Configuration › Policies › Administrative Templates › Brave Software › Brave
Supported on
Microsoft Windows 7 or later
ADMX file
brave.admx
Internal name
brave/WebAppInstallForceList

Explanation

Setting the policy specifies a list of web apps that install silently, without user interaction, and which users can't uninstall or turn off.

Each list item of the policy is an object with a mandatory member:
url (the URL of the web app to install)

and 6 optional members:
- default_launch_container
(for how the web app opens—a new tab is the default)

- create_desktop_shortcut
(True if you want to create Linux and
Microsoft® Windows® desktop shortcuts).

- fallback_app_name
(Starting with Brave version 90,
allows you to override the app name if it is not a
Progressive Web App (PWA), or the app name that is temporarily
installed if it is a PWA but authentication is required before the
installation can be completed. If both
custom_name and
fallback_app_name are provided,
the latter will be ignored.)

- custom_name
(Starting with Google Chrome OS
version 99, and version 112 on all other desktop operating systems, allows you to
permanently override the app name for all web apps and PWAs.)

- custom_icon
(Starting with Google Chrome OS
version 99, and version 112 on all other desktop operating systems, allows you to
override the app icon of installed apps. The icons have to be square,
maximal 1 MB in size, and in one of the following formats: jpeg, png, gif, webp, ico.
The hash value has to be the SHA256 hash of the icon file. The url
should be accessible without authentication to ensure the icon can be used
upon app installation.)

- install_as_shortcut
(Starting with Brave
version 107). If enabled the given url
will be installed as a shortcut, as if done via the "Create Shortcut..."
option in the desktop browser GUI.
Note that when installed as a shortcut it won't be updated if the
manifest in url changes.
If disabled or unset, the web app at the given
url will be installed normally.

See PinnedLauncherApps for pinning apps to the Google Chrome OS shelf.
See https://chromeenterprise.google/policies/?policy=WebAppInstallForceList for more information about schema and formatting.

Example value:

[
{
"create_desktop_shortcut": true,
"default_launch_container": "window",
"url": "https://www.google.com/maps"
},
{
"default_launch_container": "tab",
"url": "https://docs.google.com"
},
{
"default_launch_container": "window",
"fallback_app_name": "Editor",
"url": "https://docs.google.com/editor"
},
{
"custom_name": "My important document",
"default_launch_container": "window",
"install_as_shortcut": true,
"url": "https://docs.google.com/document/d/ds187akjqih89"
},
{
"custom_icon": {
"hash": "c28f469c450e9ab2b86ea47038d2b324c6ad3b1e9a4bd8960da13214afd0ca38",
"url": "https://mydomain.example.com/sunny_icon.png"
},
"url": "https://weather.example.com"
}
]

Registry

HKEY_LOCAL_MACHINE\Software\Policies\BraveSoftware\Brave
HKEY_CURRENT_USER\Software\Policies\BraveSoftware\Brave
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/WebAppInstallForceList
$k = 'HKLM:\Software\Policies\BraveSoftware\Brave'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# URLs for Web Apps to be silently installed.
Set-ItemProperty -Path $k -Name 'WebAppInstallForceList' -Value '<value>' -Type String

Disable

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

Revert to "Not configured"

# Revert to "Not configured": brave/WebAppInstallForceList
$k = 'HKLM:\Software\Policies\BraveSoftware\Brave'
Remove-ItemProperty -Path $k -Name 'WebAppInstallForceList' -ErrorAction SilentlyContinue

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
URLs for Web Apps to be silently installed.WebAppInstallForceListText boxtextWebAppInstallForceListREG_SZ
Max length: 1000000

Application

Brave (Brave Software) — November 2026 templates

Official templates downloaded on November 12, 2026.