Skip to Content
Platform.Ontology

Install prompt (beforeinstallprompt) and manifest install

Lets a site offer to install itself as an app on the device.

Works without askingHome screen and system linksInstallWeb browsersWhile you use it

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

BrowserStatusFirst versionReleasedNote
ChromeSupported392014-11-18<code>display</code> and/or <code>display_override</code> are required for a web app to be installable.
EdgeSupported792020-01-15<code>display</code> and/or <code>display_override</code> are required for a web app to be installable.
FirefoxNot supportedNot availableNot listedNo installable PWAs on desktop
SafariPartial172023-09-18Add to Dock on macOS; no beforeinstallprompt
Safari on iPhonePartial11.32018-03-29Add to Home Screen via Share sheet
Chrome on AndroidSupported392014-11-12<code>display</code> and/or <code>display_override</code> are required for a web app to be installable.
Samsung InternetSupported4.02016-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

APIwindow.addEventListener('beforeinstallprompt', e=>e.prompt()); manifest.webmanifest with name, icons, start_url, display, id
Browser compat keysmanifests.webapp.display
How access is grantedgesture
What the user seesBrowser install dialog; Add to Home Screen sheet on iOS
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 site offer to install itself as an app on the device.
Shape: object
How often: on demand

FieldTypeUnitRangePrecision
manifest.displayenumNonefullscreen, standalone, minimal-ui, browserNot listed
manifest.display_overridelistNonewindow-controls-overlay, tabbed, ...Not listed
manifest.idstringNonestable app identityChrome 96, Safari 17
iconslistpixels192 and 512 recommendedNot 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

TypeExampleApps
socialInstagram or X offers an Install button, and the site becomes an icon with a full screen window.X, Pinterest
gamesA browser game offers to install, so it opens full screen and loads offline from the home screen.Poki
musicA web music player installs as its own app with media keys.None named
shoppingA store installs as an app and sends push alerts for deals.AliExpress, Starbucks
productivityA web design or office tool installs to feel like a desktop program.Figma, Google Docs
videoA web cloud gaming service installs so it runs full screen with controller support.Xbox Cloud Gaming
travelA travel site installs for offline boarding passes and trip details.Uber
newsA 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

Good uses and abuse

Legitimate uses

  • Native-like PWA

Known abuse

  • Fake install prompts

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction1 of 5How much the user has to do
Fingerprint bitsNot ratedRough 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.

On this page