Web Install API (navigator.install)
Lets a page install another web app, or itself, with one call.
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
| Browser | Status | First version | Note |
|---|---|---|---|
| Chrome | Behind a flag | 154 | Origin trial 143 to 148 |
| Edge | Not supported | Not available | None |
| Firefox | Not supported | Not available | None |
| Safari | Not supported | Not available | None |
| Safari on iPhone | Not supported | Not available | None |
| Chrome on Android | Not supported | Not available | None |
| Samsung Internet | Not supported | Not available | None |
How a site asks for it
| API | navigator.install(manifestUrl?), <install> element origin trial |
| Browser compat keys | api.Navigator.install |
| How access is granted | origin-trial |
| What the user sees | Install dialog |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | Per origin |
| How to take it back | Site settings |
| Inside an iframe | Same as top level; cross-origin iframes need a permissions policy where listed |
Typical flow
- Call the API
- Browser applies its access rules
- 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
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
result | object | None | manifest id and install state | Not 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
| Type | Example | Apps |
|---|---|---|
| games | A web game portal has an Install button that adds the game to your home screen in one click. | Poki |
| shopping | A store site installs its web app from a banner button. | None named |
| enterprise | A company page installs staff tools from a list on its intranet. | None named |
| education | A school portal installs learning apps for students on shared devices. | None named |
| productivity | A web app directory installs a tool with one click, with no store needed. | None named |
| music | A web player installs itself right after your first listen. | None named |
| social | A social site offers Install after you sign in, with one click. | None named |
Risks
- Pushy install prompts
- In testing
What the platform says
- Google Chrome: Web Install API. Lets a page start the install of a web app from a script, so a store style page can install apps in one click.
Good uses and abuse
Legitimate uses
- App store like install links
Known abuse
- Install spam
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 3 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough 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.