Configure list of force-installed Web Apps
Jump to overview

Policy overview

Key metadata and intent for this policy.

Category
Microsoft Edge
Supported on
Microsoft Edge version 80, Windows 7 or later

Supported OS tags: Windows7

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" } ]

Internal name
WebAppInstallForceList
Policy ID
ca4e9d213efa
Elements
1

Registry values

How enabled and disabled states update the registry.

No explicit registry values are set for enabled or disabled states.

Policy elements

Inputs and configuration options exposed by this policy.

ScopeElementTypeRegistry mappingConstraints & behaviorCopy
Configure list of force-installed Web Apps
ID WebAppInstallForceList
text
Path
Software\Policies\Microsoft\Edge
Value name
WebAppInstallForceList
Type
REG_SZ
None
Configure list of force-installed Web Apps
Both · Type text
Registry mapping
Path
Software\Policies\Microsoft\Edge
Value name
WebAppInstallForceList
Type
REG_SZ
DetailsNone