Don't miss out on the action at this year's Chrome Dev Summit, streaming live on YouTube. Watch now.

User Can Be Prompted To Install The Web App

Why the audit is important

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.

How to pass the audit

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.

How the audit is implemented

This section explains how this audit is implemented, so that you can understand how the audit's score is calculated.

The audit passes if all of the criteria specified in How to pass the audit are met.

Audit source