Skip to content

Chrome 158 ships the Web Install API, no more beforeinstallprompt

navigator.install() lets a site trigger a web app install, including cross-origin, replacing a non-standard event every PWA builder had to special-case.

Chrome 158, which reached the stable channel on 12 November, ships the Web Install API. Calling navigator.install() triggers a browser-native install prompt for a web app, given a manifest URL and an optional manifest ID, and it works cross-origin: one site can now offer to install another site’s web app.

await navigator.install({
  manifest: 'https://app.example/manifest.webmanifest',
  manifestId: 'https://app.example/',
});

The call must run inside a user action, such as a click handler, or it fails with NotAllowedError. A bad manifest throws DataError; a cancelled or unsupported install throws AbortError. There’s also a declarative <install> element that renders a browser-controlled button with no JavaScript required. Both ship on Windows, Mac, Linux and ChromeOS. Android is deferred, Chrome’s team cites differences in that platform’s app ecosystem, and there’s no plan for WebView support.

Why it matters: beforeinstallprompt was non-standard, Chrome-only, and fired unpredictably. navigator.install() is a direct, promise-based replacement with proper error codes, and the cross-origin case opens things like app directories or landing pages that can install a PWA on a user’s behalf without redirecting them first.

The caveat: this is desktop Chrome only for now. Anything shipping today still needs the old beforeinstallprompt listener as a fallback for other browsers and for Android.

Share

More from The Wire

All briefs