Adds a "launch_handler" app manifest member that enables web apps to customise their launch behaviour across all types of app launch triggers. Example usage: { "name": "Example app", "start_url": "/index.html", "launch_handler": { "route_to": "existing", "navigate_existing_client": "always" } } This will cause all launches of the Example app to focus an existing app window and navigate it (if it exists) instead of always launching a new app window.


Web apps currently cannot control whether they're launched in a new app window or whether an existing window is reused. This feature helps support web apps that wish to remain in a single window on desktop platforms.

Status in Chromium


In developer trial (Behind a flag) (tracking bug)

Consensus & Standardization

After a feature ships in Chrome, the values listed here are not guaranteed to be up to date.

  • No signal
  • No signal
  • No signals


Intent to Prototype url

Intent to Prototype thread


This feature is a lower level primitive motivated by Declarative Link Capturing:

Search tags

web app, pwa, link capturing, link handling, launch,

Last updated on 2021-12-05