Ready for Trial: PWA manifest unique id - desktop

Skip to first unread message

Phillis Tang

Sep 9, 2021, 4:37:59 PM9/9/21

Contact emails



Design docs


Define an optional id field in the app manifest that's used to globally identify the web app. If the id is not specified, start_url will be used as the default id.

Blink component


TAG review

TAG review status



Interoperability and Compatibility

Low interoperability & compatibility risks: For browsers that do not implement it yet, a web app that specifies the id field will just be ignored and function as normal. The only behavior difference is the app can update its start_url when it has id specified on Chrome but not on other browsers.

Gecko: No signal (

WebKit: No signal (

Web developers: Positive ( manfest spec editors marcoscaceres overall agrees to the change




The feature will go together with UX changes in devtool and lighthouse to instruct users. A devrel post will also be created to inform developers about the new feature.


Goals for experimentation

Test it function as expected. We plan to skip Intent to Experiment and move to Intent to Ship after DevTrial, as it's a single string field in the manifest that doesn't provide functional change to users and we don't expect to get useful feedback about API shape.

Ongoing technical constraints


The raw manifest json can be viewed in devtools->Application->Manifest. The compuated app id can be viewed in devtools->Application->Identity-> App Id

Will this feature be supported on all six Blink platforms (Windows, Mac, Linux, Chrome OS, Android, and Android WebView)?


Currently only Windows, Linux, Mac, Chrome OS Android implementation is done in a different timeline, and planned to be done on 2022 Q1.

Is this feature fully tested by web-platform-tests?

Manual tests are written, currently under review

DevTrial instructions

Flag name


Requires code in //chrome?


Tracking bug

Launch bug

Estimated milestones

DevTrial on desktop94

Link to entry on the Chrome Platform Status

Links to previous Intent discussions

Intent to prototype:

This intent message was generated by Chrome Platform Status.

Michael Landry

Sep 30, 2021, 2:51:02 PM9/30/21
to blink-dev, Phillis Tang,
This is an extremely useful feature for Google Chat, and Workspace in general. PWA path migration has been a barrier in the past and having the flexibility to seamlessly update the manifest without changing the app identity will be needed in the future. In my local testing I can confirm this works as expected!
Reply all
Reply to author
0 new messages