Skip to Content
Platform.Ontology

Web Install API (navigator.install)

Lets a page install another web app, or itself, with one call.

Works without askingHome screen and system linksInstallWeb browsersWhile you use it

In one line

Can offer to install a web app with one call, but you still approve it

Lets a page install another web app, or itself, with one call.

Turns a link into an install button; the user still approves. Still an origin trial on desktop Chromium.

What it can and can't do

What the user does: You tap an Install button on a page and confirm in the dialog

It can

  • Show an install dialog for itself or for another web app
  • Turn a link into an install button
  • Work only on sites in the Chrome trial

It cannot

  • Install anything without your approval
  • Work for most visitors yet, since it is still a trial
  • Work in Edge, Firefox, Safari or on phones
  • Skip the browser's own dialog

How it differs between platforms: Only desktop Chrome in a testing trial today.

Browser support

BrowserStatusFirst versionNote
ChromeBehind a flag154Origin trial 143 to 148
EdgeNot supportedNot availableNone
FirefoxNot supportedNot availableNone
SafariNot supportedNot availableNone
Safari on iPhoneNot supportedNot availableNone
Chrome on AndroidNot supportedNot availableNone
Samsung InternetNot supportedNot availableNone

How a site asks for it

APInavigator.install(manifestUrl?), <install> element origin trial
Browser compat keysapi.Navigator.install
How access is grantedorigin-trial
What the user seesInstall dialog
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsPer origin
How to take it backSite settings
Inside an iframeSame as top level; cross-origin iframes need a permissions policy where listed

Typical flow

  1. Call the API
  2. Browser applies its access rules
  3. Page receives the result

Data you get

What comes back: Lets a page install another web app, or itself, with one call.
Shape: object
How often: on demand

FieldTypeUnitRangePrecision
resultobjectNonemanifest id and install stateNot listed

Technical limits

  • Origin trial only
  • Needs user gesture
  • Chrome flag in 154

The story

What it is

A page can install another web app, or itself, with a single call and no menu hunt.

For you

You click an Install button on a page, and the app installs. The browser may ask you to confirm. It is meant to make installing as simple as in an app store.

For makers

Makers can build app catalogs and install buttons on the web. It cuts the steps from visit to installed app, which lifts install rates. It is in testing, so it is not widely used yet.

Where you see it

TypeExampleApps
gamesA web game portal has an Install button that adds the game to your home screen in one click.Poki
shoppingA store site installs its web app from a banner button.None named
enterpriseA company page installs staff tools from a list on its intranet.None named
educationA school portal installs learning apps for students on shared devices.None named
productivityA web app directory installs a tool with one click, with no store needed.None named
musicA web player installs itself right after your first listen.None named
socialA social site offers Install after you sign in, with one click.None named

Risks

  • Pushy install prompts
  • In testing

What the platform says

Good uses and abuse

Legitimate uses

  • App store like install links

Known abuse

  • Install spam

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction3 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2025-09, Chrome 143: Origin trial starts on desktop (M143 to 148, extension requested to 153)
  • 2026-05, Chrome 148: Declarative <install> element trial to 153

Sources

How well checked: Based on official documentation.

On this page