Configure list of force-installed Web Apps

Policy ID
WebAppInstallForceList
Scope
Computer Configuration, User Configuration
Supported on
Microsoft Edge version 80, Windows 7 or later
Source
Microsoft Edge Policy Templates (version 155.0.4283.45)
Category
Microsoft Edge

Description

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

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 Microsoft Edge version 90,
you can permanently override the app name if it's not a Progressive Web App (PWA)
or you can temporarily override the app name if authentication is required before
installation can be completed. If both
custom_name and
fallback_app_name are provided,
the latter is ignored.)

- custom_name
(Starting with Microsoft Edge version 112
on all desktop platforms, you can permanently override the app name for all
web apps and PWAs.)

- custom_icon
(Starting with Microsoft Edge version 112
on all desktop platforms, you can 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 that the icon can be used upon app installation.)

- install_as_shortcut
(Starting with Microsoft Edge
version 107). If enabled, the given url is installed as a shortcut,
as if done via the "Create Shortcut..." option in the desktop browser GUI.
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 is installed normally.
(This isn't currently supported in Microsoft Edge.)

The 'WebAppInstallByUserEnabled' policy doesn't affect this policy. Web apps specified by this policy are installed regardless of the 'WebAppInstallByUserEnabled' policy setting.

Example value:

[
{
"create_desktop_shortcut": true,
"default_launch_container": "window",
"url": "https://www.contoso.com/maps"
},
{
"default_launch_container": "tab",
"url": "https://app.contoso.edu"
},
{
"default_launch_container": "window",
"fallback_app_name": "Editor",
"url": "https://app.contoso.edu/editor"
},
{
"custom_name": "Spreadsheets",
"default_launch_container": "window",
"install_as_shortcut": true,
"url": "https://app.contoso.edu/sheets"
},
{
"custom_icon": {
"hash": "c28f469c450e9ab2b86ea47038d2b324c6ad3b1e9a4bd8960da13214afd0ca38",
"url": "https://mydomain.example.com/sunny_icon.png"
},
"url": "https://weather.example.com"
}
]

Options

  • Configure list of force-installed Web Apps

Registry

ComputerHKEY_LOCAL_MACHINE
  • WebAppInstallForceListREG_SZ
UserHKEY_CURRENT_USER
  • WebAppInstallForceListREG_SZ

Other policies in the same category

View all policies in this category (438)