Native App Install Banners

Native app install banner

Native app install banners give you the ability to let users quickly and seamlessly install your native app on their device from the app store, without leaving the browser, and without showing an annoying interstitial.

When is the banner shown?

Chrome will automatically show the native app install prompt to the user when the following criteria are met:

  • Neither the web app or the native app are already installed
  • Meets a user engagement heuristic (currently, the user has interacted with the domain for at least 30 seconds)
  • Includes a Web App Manifest that includes:
  • Served over HTTPS

If your site has a restrictive Content Security Policy, make sure to add *.googleusercontent.com to the img-src directive so Chrome can download the icon associated with your app from the Play Store.

Required manifest properties

To prompt the user to install your native app, you need to add two properties to your web app manifest, prefer_related_applications and related_applications.

"prefer_related_applications": true,
"related_applications": [
  {
    "platform": "play",
    "id": "com.google.samples.apps.iosched"
  }
]

The prefer_related_applications property tells the browser to prompt the user with your native app instead of the web app. Leaving this value unset, or false, the browser will prompt the user to install the web app instead.

related_applications is an array with a list of objects that tell the browser about your preferred native application. Each object must include a platform property and an id property. Where the platform is play and the id is your Play Store app ID.