caption: Configure list of force-installed Web Apps
desc: |-
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:
<ph name="URL_LABEL">url</ph> (the URL of the web app to install)
and 6 optional members:
- <ph name="DEFAULT_LAUNCH_CONTAINER_LABEL">default_launch_container</ph>
(for how the web app opens—a new tab is the default)
- <ph name="CREATE_DESKTOP_SHORTCUT_LABEL">create_desktop_shortcut</ph>
(True if you want to create <ph name="LINUX_OS_NAME">Linux</ph> and
<ph name="MS_WIN_NAME">Microsoft® Windows®</ph> desktop shortcuts).
- <ph name="FALLBACK_APP_NAME_LABEL">fallback_app_name</ph>
(Starting with <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> 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
<ph name="CUSTOM_NAME_LABEL">custom_name</ph> and
<ph name="FALLBACK_APP_NAME_LABEL">fallback_app_name</ph> are provided,
the latter will be ignored.)
- <ph name="OVERRIDE_APP_NAME_LABEL">custom_name</ph>
(Starting with <ph name="PRODUCT_OS_NAME">$2<ex>Google ChromeOS</ex></ph>
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.)
- <ph name="CUSTOM_ICON_LABEL">custom_icon</ph>
(Starting with <ph name="PRODUCT_OS_NAME">$2<ex>Google ChromeOS</ex></ph>
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.)
- <ph name="INSTALL_AS_SHORTCUT_LABEL">install_as_shortcut</ph>
(Starting with <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>
version 107). If enabled the given <ph name="URL_LABEL">url</ph>
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 <ph name="URL_LABEL">url</ph> changes.
If disabled or unset, the web app at the given
<ph name="URL_LABEL">url</ph> will be installed normally.
See <ph name="PINNED_LAUNCHER_APPS_POLICY_NAME">PinnedLauncherApps</ph> for pinning apps to the <ph name="PRODUCT_OS_NAME">$2<ex>Google ChromeOS</ex></ph> shelf.
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
features:
dynamic_refresh: true
per_profile: true
future_on:
- fuchsia
label: URLs for Web Apps to be silently installed.
owners:
- file://chrome/browser/web_applications/OWNERS
- [email protected]
schema:
items:
properties:
create_desktop_shortcut:
type: boolean
custom_icon:
properties:
hash:
type: string
url:
type: string
required:
- url
- hash
type: object
custom_name:
type: string
default_launch_container:
enum:
- tab
- window
type: string
fallback_app_name:
type: string
install_as_shortcut:
type: boolean
url:
type: string
required:
- url
type: object
type: array
supported_on:
- chrome.*:75-
- chrome_os:75-
tags: []
type: dict
Codebase Browser
chromium