User Can Be Prompted To Install The Web App

Overview

The prompt to install a web app lets users add your app to their homescreen. Users that add apps to homescreens engage those apps more.

For example, shortly after launching this feature, Twitter reported an average of 250K unique daily users launching their Twitter Lite progressive web app 4 times a day from the homescreen. See Increasing engagement with "Add to Homescreen" prompt and web push notifications for more on Twitter's case study.

Recommendations

Google Chrome automatically displays the install prompt once it detects that a site qualifies as a Progressive Web App. These are Chrome's criteria:

  • The site is served over HTTPS. HTTPS is required for registering a service worker. See Uses HTTPS.
  • A service worker is registered.
  • The scope of the service worker includes the page you audited and the page specified in the start_url property of the web app manifest.
  • A web app manifest exists and meets the following criteria:
    • Has a valid name property.
    • Has a valid short_name property.
    • Has a valid start_url property.
    • Has a valid display property and the value is standalone, fullscreen, or minimal-ui.
    • Specifies an icon that is at least 192px by 192px.

See Web App Install Banners to learn more.

More information

Audit source