Concept in Installation
Uninstalling an installed PWA
Published Updated
Uninstalling a web app removes its icon, standalone window registration, file-handler and protocol-handler registrations, and, on some platforms, its storage. You can uninstall it from the installing browser or the operating system’s app list; the entry point depends on the platform. Chrome and Edge on desktop expose it from chrome://apps and edge://apps and from the app window’s own menu; Windows lists Chromium web apps in Settings › Apps; Safari on iOS removes a Home Screen web app like any other app; Safari on macOS 14 and later removes a Dock web app from the Applications folder (MDN “Installing and uninstalling web apps”, Microsoft Edge PWA documentation).
How it works
Section titled “How it works”Installation registers the app with the operating system (a shortcut or app bundle, an entry in the OS app list, optional file and protocol handlers), and uninstallation reverses those registrations through whichever surface the platform provides. MDN documents that uninstalling “does more than remove the PWA’s icon” without enumerating the steps; the per-platform surfaces are:
| Platform | Where the uninstall action is (English UI) | What happens to site data |
|---|---|---|
| Chrome, desktop | The app window’s More menu › Uninstall [app name] › Remove; apps are also managed from chrome://apps (Chrome Help) |
The dialog has an opt-in checkbox to delete the app’s data from Chrome. Chrome Help words it “Also delete data from Chrome” and the Chromium source string reads “Remove this app’s data from Chrome”. Chromium clears site data only when it is checked |
| Edge, desktop | edge://apps › the app’s … menu or Details › Uninstall; or the app window’s … menu |
Microsoft’s documentation lists these uninstall entry points and does not describe the uninstall dialog’s options |
| Windows 10 and 11 | Settings › Apps › Installed apps lists Chromium web apps alongside native apps, with the installing browser as publisher; Uninstall there removes the app (Microsoft Edge PWA documentation) | Not described in the cited sources |
| macOS 14+ Safari web apps | Drag the app from ~/Applications/ (Finder) to the Trash |
The web app’s separate data store is removed with it |
| iOS and iPadOS 16.4+ | Long-press the icon and choose the delete option (MDN: removing the icon from the home screen deletes the PWA). For iPhone apps in general, Apple’s guide lists Remove App › Delete App, and Remove from Home Screen keeps an app in the App Library, which may not apply to Home Screen web apps | Apple’s guide says deleting an app removes its data. The cited sources do not say how this applies to Home Screen web apps or to Safari data for the same origin |
| Android, Chrome WebAPK | Settings › Apps › the app › Uninstall | Chrome keeps the origin’s browser-profile storage; the WebAPK had no separate store |
Because an install belongs to the browser that made it, removing one browser’s copy does not affect another’s (the N+1 problem), and a page has no event for its own uninstallation: appinstalled has no counterpart, so sign-out, push-subscription cleanup, and server-side device records have no trigger from the uninstall itself. Use tokens that expire and prune subscriptions server-side when pushes fail with 410 Gone to avoid records that need uninstall-triggered cleanup. Otherwise, stale records remain after uninstallation.
Observed behaviour
Section titled “Observed behaviour”Microsoft’s documentation lists edge://apps › Open › Details and Windows Settings › Apps as places to view an app’s information or uninstall it. The cited sources do not say whether those entry points open the dialog described above. A page cannot detect any of this; getInstalledRelatedApps() reports a related app’s presence only while it is installed, from the same browser, and only when the manifest lists it, so a drop from one result to zero is the nearest signal, and it is observable only on the next visit in a tab.
See also
Section titled “See also”- Installing and uninstalling web apps (developer.mozilla.org)
- The UX of PWAs in Microsoft Edge (learn.microsoft.com)
- Web Push for Web Apps on iOS and iPadOS (webkit.org)
- The N+1 install problem
- Desktop installation
- iOS Add to Home Screen
- getInstalledRelatedApps()
Specifications
| Specification | Status |
|---|---|
| None. | |