How it works
Your PWA is generated based on the details specified in your web app manifest. Browsers that run on the Chromium engine, like Chrome and Edge, regularly check for updates in your manifest. If these browsers spot any modifications in your manifest, they will adjust the installed apps as needed.
On iOS, your app can't be updated after installation. On Desktop/Android, your app can be updated, but your app icons will remain unchanged.
The following are the properties of the app manifest that can be modified after the app is installed, as well as those that prompt the system to renew your app upon detecting changes:
Windows/macOS
Modifiable after installation: all properties, except
icons
Trigger an update:
display
,name
,short_name
,scope, shortcuts, start_url, theme_color, file_handlers
Android
Modifiable after installation: all properties, except
icons
,short_name
, andname
Trigger an update:
background_color, display, orientation, scope, shortcuts, start_url, theme_color, web_share_target
iOS
Modifiable after installation: none
Trigger an update: none
Unfortunately, on iOS, none of the fields of your app's manifest will update. That means that you can't update your app's name
, icon
, start_url
or any other fields of the manifest after installation. Users will have to reinstall your app.
Learn more
See how Chrome handles manifest changes on web.dev