Skip to Content
Platform.Ontology

getInstalledRelatedApps

Lets a site check whether its own native app is installed.

Gets silentlyContacts and personal dataApp presenceWeb browsersWhen the page loadsWhile you use it

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

BrowserStatusFirst versionReleasedNote
ChromeSupported852020-08-25Supported on Windows for checking of Universal Windows Platform (UWP) app installation. Resolves with an empty array on other platforms.
EdgeSupported852020-08-27Supported on Windows for checking of Universal Windows Platform (UWP) app installation. Resolves with an empty array on other platforms.
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidSupported842020-07-27Supports checking of Progressive Web App (PWA) installation.
Samsung InternetSupported14.02021-04-17Supports checking of Progressive Web App (PWA) installation.

How a site asks for it

APInavigator.getInstalledRelatedApps()
Browser compat keysapi.Navigator.getInstalledRelatedApps
How access is grantednone
What the user seesNone
Needs a secure context (HTTPS)Yes
Needs a user gestureNo
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 check whether its own native app is installed.
Shape: object
How often: on demand

FieldTypeUnitRangePrecision
platformenumNoneplay, chromeos_play, webapp, windows, f-droid, amazonNot listed
idstringNonepackage or app idNot listed
urlstringNonemanifest urlNot 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

TypeExampleApps
shoppingA store hides its install banner when you already have the app.Amazon, Walmart
socialA social site sends you to its app instead of asking you to install.X, Instagram
mediaA music site skips the 'get our app' pop up if it is installed.Spotify
gamesA web game page hides its install ad once you installed the app.None named
adsAn ad system treats app users as a different, more valuable audience.None named
analyticsA product team counts how many web visitors also have the app.None named

Risks

  • App presence signal
  • Chromium only

What the platform says

Good uses and abuse

Legitimate uses

  • Hide install prompt

Known abuse

  • App presence as signal

Scores

ScoreValueMeaning
Sensitivity2 of 5How revealing the data is
Utility2 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits1Rough 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.

On this page