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. The <ph name="URL_LABEL">url</ph>
        should be accessible without authentication to ensure the icon can be used
        upon app installation.)

        - <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
- ortuno@chromium.org
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
