getInstalledRelatedApps
Lets a site check whether its own native app is installed.
In one line
Can check if its own app is installed, but not see your other apps
Lets a site check whether its own native app is installed.
Reveals only whether the site's declared related app is installed, to hide install banners.
What it can and can't do
What the user does: Nothing. It happens when the page loads, to show Open in app or Get the app.
It can
- Check if its own app is installed on your device
- Show Open in app instead of Get the app
- Check apps that the site has linked to itself in its settings
It cannot
- See a list of your installed apps
- Check apps that are not linked to the site
- Work in Firefox, Safari or on iPhone
- Say what version or how often you use the app
How it differs between platforms: Chrome and Edge on Android support it. Firefox, Safari and iPhone do not.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 85 | 2020-08-25 | Supported on Windows for checking of Universal Windows Platform (UWP) app installation. Resolves with an empty array on other platforms. |
| Edge | Supported | 85 | 2020-08-27 | Supported on Windows for checking of Universal Windows Platform (UWP) app installation. Resolves with an empty array on other platforms. |
| Firefox | Not supported | Not available | Not listed | None |
| Safari | Not supported | Not available | Not listed | None |
| Safari on iPhone | Not supported | Not available | Not listed | None |
| Chrome on Android | Supported | 84 | 2020-07-27 | Supports checking of Progressive Web App (PWA) installation. |
| Samsung Internet | Supported | 14.0 | 2021-04-17 | Supports checking of Progressive Web App (PWA) installation. |
How a site asks for it
| API | navigator.getInstalledRelatedApps() |
| Browser compat keys | api.Navigator.getInstalledRelatedApps |
| How access is granted | none |
| What the user sees | None |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | No |
| 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 check whether its own native app is installed.
Shape: object
How often: on demand
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
platform | enum | None | play, chromeos_play, webapp, windows, f-droid, amazon | Not listed |
id | string | None | package or app id | Not listed |
url | string | None | manifest url | Not listed |
Technical limits
- Only apps listed in manifest related_applications that also link back
- No general app list
- Not in Firefox or Safari
The story
What it is
A site can check if its own app is installed on your device.
For you
You never see it. A site can hide its 'install our app' banner if it finds the app on your device.
For makers
Makers use it to hide install prompts and to nudge you into the app where they make more money. The result also tells them whether you are an app user, which they can use in profiles.
Where you see it
| Type | Example | Apps |
|---|---|---|
| shopping | A store hides its install banner when you already have the app. | Amazon, Walmart |
| social | A social site sends you to its app instead of asking you to install. | X, Instagram |
| media | A music site skips the 'get our app' pop up if it is installed. | Spotify |
| games | A web game page hides its install ad once you installed the app. | None named |
| ads | An ad system treats app users as a different, more valuable audience. | None named |
| analytics | A product team counts how many web visitors also have the app. | None named |
Risks
- App presence signal
- Chromium only
What the platform says
- Google: getInstalledRelatedApps(). Chrome's docs say the API lets a site check whether its own app is installed.
Good uses and abuse
Legitimate uses
- Hide install prompt
Known abuse
- App presence as signal
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 2 of 5 | How revealing the data is |
| Utility | 2 of 5 | How useful it is to honest apps |
| Friction | 0 of 5 | How much the user has to do |
| Fingerprint bits | 1 | Rough identifying entropy, when known |
History
- 2017, Chrome 84: Android
- 2021-02, Chrome 85: Desktop for webapp/windows
Sources
How well checked: Checked against real behavior.