Skip to content

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).

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.

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.

Specifications

SpecificationStatus
None.