Install prompt (beforeinstallprompt) and manifest install
Lets a site offer to install itself as an app on the device.
In one line
Can offer to install the site as an app, but only you can accept
Lets a site offer to install itself as an app on the device.
An installed app gets its own window and icon, and unlocks install only features (badging, file handling, shortcuts).
What it can and can't do
What the user does: You tap Install app, or Add to Home Screen on iPhone
It can
- Show an install offer after you tap a button on the page
- Give the site its own window and icon once you accept
- Unlock install only features like badges, file opening and shortcuts
It cannot
- Install anything without your say so
- Skip the browser's own install dialog
- Show an install button on Safari, where you add the site from the Share menu
- Install in Firefox on computers, which has no install
How it differs between platforms: Chrome, Edge and Samsung Internet offer a prompt. On iPhone you add the site from the Share menu. Firefox on computers has no install.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 39 | 2014-11-18 | <code>display</code> and/or <code>display_override</code> are required for a web app to be installable. |
| Edge | Supported | 79 | 2020-01-15 | <code>display</code> and/or <code>display_override</code> are required for a web app to be installable. |
| Firefox | Not supported | Not available | Not listed | No installable PWAs on desktop |
| Safari | Partial | 17 | 2023-09-18 | Add to Dock on macOS; no beforeinstallprompt |
| Safari on iPhone | Partial | 11.3 | 2018-03-29 | Add to Home Screen via Share sheet |
| Chrome on Android | Supported | 39 | 2014-11-12 | <code>display</code> and/or <code>display_override</code> are required for a web app to be installable. |
| Samsung Internet | Supported | 4.0 | 2016-03-11 | <code>display</code> and/or <code>display_override</code> are required for a web app to be installable. |
How a site asks for it
| API | window.addEventListener('beforeinstallprompt', e=>e.prompt()); manifest.webmanifest with name, icons, start_url, display, id |
| Browser compat keys | manifests.webapp.display |
| How access is granted | gesture |
| What the user sees | Browser install dialog; Add to Home Screen sheet on iOS |
| 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 site offer to install itself as an app on the device.
Shape: object
How often: on demand
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
manifest.display | enum | None | fullscreen, standalone, minimal-ui, browser | Not listed |
manifest.display_override | list | None | window-controls-overlay, tabbed, ... | Not listed |
manifest.id | string | None | stable app identity | Chrome 96, Safari 17 |
icons | list | pixels | 192 and 512 recommended | Not listed |
Technical limits
- beforeinstallprompt is Chromium only
- iOS needs manual Share > Add to Home Screen
- In the EU, non WebKit engines may not support install on iOS
The story
What it is
A site can offer to install itself as an app on your device, with its own icon and window.
For you
You may see an Install button or banner. After you tap it, the site gets its own icon and window and feels like an app. You can remove it any time.
For makers
Makers skip app stores and fees, ship one codebase and get an icon on the home screen. Installed apps get more features like push and badging. Install rates are a growth metric for them.
Where you see it
| Type | Example | Apps |
|---|---|---|
| social | Instagram or X offers an Install button, and the site becomes an icon with a full screen window. | X, Pinterest |
| games | A browser game offers to install, so it opens full screen and loads offline from the home screen. | Poki |
| music | A web music player installs as its own app with media keys. | None named |
| shopping | A store installs as an app and sends push alerts for deals. | AliExpress, Starbucks |
| productivity | A web design or office tool installs to feel like a desktop program. | Figma, Google Docs |
| video | A web cloud gaming service installs so it runs full screen with controller support. | Xbox Cloud Gaming |
| travel | A travel site installs for offline boarding passes and trip details. | Uber |
| news | A news site installs as an app, to get push alerts and an icon. | None named |
Risks
- Prompts can nag
- Looks like a real app
What the platform says
- MDN Web Docs: Making PWAs installable. Sites that meet some rules can be installed from the browser like an app, without an app store.
- WebKit: Add to Dock in Safari. Safari 17 lets any website be added to the Mac Dock as a web app.
Good uses and abuse
Legitimate uses
- Native-like PWA
Known abuse
- Fake install prompts
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 4 of 5 | How useful it is to honest apps |
| Friction | 1 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2015, Chrome 44: beforeinstallprompt ships (Edge 79, Samsung 5)
- 2023-07, Chrome: Chrome on iOS gets Add to Home Screen after iOS 16.4
- 2023-09, Safari 17: Safari 17 adds Add to Dock on macOS
- 2025-09, Safari on iPhone 26: Every Home Screen site opens as a web app by default
Sources
How well checked: Checked against real behavior.