WebAppInstallForceList

Configure list of force-installed Web Apps

Supported on:

  • Chrome (Windows) since version 75

Description:

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 Microsoft® Windows® desktop shortcuts).

  • fallback_app_name
    (Starting with Samsung Browser 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 Samsung Browser
    version 112 on Microsoft® Windows®, allows you to
    permanently override the app name for all web apps and PWAs.)

  • custom_icon
    (Starting with Samsung Browser
    version 112 on Microsoft® Windows®, 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 Samsung Browser
    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.

Supported features:

  • Applied to browser without restart. Note that some ongoing tasks may not be affected.
  • Applied at Samsung Browser profile level.

Data type:

Dictionary
Windows:REG_SZ

Windows registry location:

Software\Policies\Samsung\Internet\WebAppInstallForceList

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

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

More policies under Miscellaneous: