![Thomas Steiner](https://web.dev/images/authors/thomassteiner.jpg) Thomas Steiner [GitHub](https://github.com/tomayac) [LinkedIn](https://www.linkedin.com/in/thomassteinerlinkedin) [Mastodon](https://toot.cafe/@tomayac) [Bluesky](https://bsky.app/profile/tomayac.com) [Homepage](https://blog.tomayac.com/) ![Dibyajyoti Pal](https://web.dev/images/authors/dibyajyotipal.jpg) Dibyajyoti Pal [LinkedIn](https://www.linkedin.com/in/dpal1996) ![Vincent Scheib](https://web.dev/images/authors/vincentscheib.jpg) Vincent Scheib [LinkedIn](https://www.linkedin.com/in/vincentscheib) ![Dan Murphy](https://web.dev/images/authors/danmurphy.jpg) Dan Murphy [X](https://twitter.com/danity_project) [LinkedIn](https://www.linkedin.com/in/daniel-murphy-09961314)

<br />

Chrome's internal user research shows that many people value installing web
apps. There are many benefits such as:

- Having a chat app launch from the operating system taskbar or dock.
- Playing music from a dedicated top level window that's visible when switching apps.
- Decluttering the browser UX for an immersive video call.
- Opening a web app directly from an associated file the operating system file explorer.

There are multiple ways Chrome and web developers can help, including a new
machine learning promotion feature. This post gives an overview of the ways
users can install your app.

## "Crafted" apps meeting the installability criteria

Apps that meet Chrome's [installability
criteria](https://web.dev/articles/install-criteria) automatically show an
install icon in the address bar of the Chrome desktop browser (highlighted in
the following screenshot). A user can click to install the app.

![Install icon in the address bar of the Chrome desktop browser.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--19csmbhtt0d.png)

An alternative way to install is going using the **More**
![More](https://developer.chrome.com/static/images/devtools-more.png)
\> **Save and Share** \> **Install $appName**.

![Install app menu item in the 'more' menu on Chrome desktop.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--w21izhcdagm.png)

On mobile, users can install the app using the displayed install prompt, or using
**More**
![More](https://developer.chrome.com/static/images/devtools-more.png) \> **Add to Home screen** \> **Install app**.

|---|---|---|
| ![Wikipedia website on mobile.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--btrkpbr68d8.png) | ![Add to home screen prompt on the Wikipedia website.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--j2ockleskzd.png) | ![Install app dialog on the Wikipedia site.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--ucigrdtm70a.png) |

These installs are called "crafted" as the developer has opted into this UX by
fulfilling the installability criteria.

### Customized install experience

Developers can take it one step further and offer a [customized install
experience](https://web.dev/articles/customize-install). This is the approach
apps like [Squoosh](https://squoosh.app/) and [SVGcode](https://svgco.de/) have
taken. See the highlighted **Install** buttons in the following examples. By
[providing screenshots](https://web.dev/patterns/web-apps/richer-install-ui),
developers can create an even richer install experience.

|---|---|---|
| ![Squoosh app and its install button.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--2d19cjq7f1z.png) | ![Squoosh app install prompt with screenshots.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--hpebuk2ayze.png) | ![SVGcode app and its install button.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--b4mx8ycj6g.png) |

## "Manual" installation of any app

Research at Google has shown that users also want to install *any* web
experiences, even if they don't meet the install criteria or offer a customized
install flow. An example is
[Wordle](https://www.nytimes.com/games/wordle/index.html). At the time of
writing, its web app manifest is missing the `icons` member and the
`start_url`.

```json
{  
    "name": "Wordle",  
    "short_name": "Wordle",  
    "theme_color": "#FFFFFF",  
    "background_color": "#FFFFFF",  
    "display": "minimal-ui"  
}  
```

For such cases, Chrome offers a manual way to
[install a page as a "manual" app](https://support.google.com/chrome/answer/9658361?sjid=5259992915796232748-EU),
highlighted in the following screenshot for desktop. At the top right of the
browser window, select **More**
![More](https://developer.chrome.com/static/images/devtools-more.png)
\> **Save and share** \> **Install Page as App**. In the
install prompt, you can change the app name to your liking.

![Install page as app menu item on Chrome for desktop.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--i057x8oiq6e.png)

![Install this page as an app dialog on Chrome for desktop.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--unwkqlv6do.png)

On mobile, tap **More**
![More](https://developer.chrome.com/static/images/devtools-more.png)
\> **Add to home screen** \> **Install app**.

|---|---|---|
| ![IMDB website on Chrome mobile.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--ggajeojgmqk.png) | ![IMDB website with add to home screen menu item on Chrome mobile.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--8umsgtwp3zf.png) | ![IMDB website with install app dialog.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/howchromehelps--9uj7fvogupo.png) |

While this works, it's not necessarily discoverable in practice. This is why the
Chrome team has invested in an approach driven by **machine learning (ML)**.

## Install prompt based on machine learning

On Android, the team uses
[Chrome segmentation](https://chromium.googlesource.com/chromium/src/+/refs/heads/main/components/segmentation_platform/README.md)
to predict whether a user will want to install a given page based on a
collection of signals, including site health characteristics (for example, the
existence of a valid manifest) and user site visitation data (for example, the
total count of site visits in the past 14 days). This data is collected and used
to train an ML model to trigger an install dialog if there's a high probability that the user will install it. If the site meets the install criteria, then this shows the
normal installation dialog, while other pages will get the manual installation
dialog.

![Wordle website with install this page as app dialog.](https://developer.chrome.com/static/blog/how_chrome_helps_users_install_the_apps_they_value/www.nytimes.com_games_wordle_index.html.png)

Initial results show that users are receptive to ML-triggered install prompts,
and the team plans on using the experiences gained so far to further fine-tune
the model to help users install the apps they want.

## Create a shortcut on desktop and mobile

From Chrome 128, **More**
![More](https://developer.chrome.com/static/images/devtools-more.png)
\> **Save and Share** \> **Create Shortcut** creates a
bookmark on the user's desktop or homescreen. This launches a specific page in a
new tab, matching Android's behavior, where you create a shortcut using **More**
![More](https://developer.chrome.com/static/images/devtools-more.png)
\> **Add to Home screen** \> **Create shortcut**.

The previous behavior of this menu item on desktop has now moved to the
**Install Page as App** option, which creates a "manual" app as described
before.

## Conclusions

Users love coming back to their apps. Sometimes in a browser tab, sometimes as a
standalone experience. Chrome helps users get there by:

- Allowing developers to craft rich installation experiences.
- Enabling users to install apps, even if their developers didn't have installability planned.
- Letting users create shortcuts to pages they want to revisit.
- Proactively suggesting apps to install based on machine learning with high confidence installation is what the user wants.

And now back to Wordle, erm, work...

Wordle 1,110 3/6
⬛⬛⬛🟨⬛ ⬛🟨⬛🟨🟩 🟩🟩🟩🟩🟩

## Acknowledgements

This document was reviewed by Finnur Breki
Thorarinsson, Ella Ge, and [Rachel Andrew](https://rachelandrew.co.uk/).