← Back to release summary

PWA manifest unique id - desktop

Category
Capabilities (Fugu)
Type
New or changed feature
Status
Enabled by default (Chrome 96)
Intent stage
Shipped

Summary

Define an optional id field in 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.

Motivation

The appmanifest spec doesn’t explicitly define what uniquely identifies a PWA. Currently, on the desktop versions of Chromium-based browsers and Firefox on Android, PWAs are uniquely identified by app's start_url and Android Chromium-based browsers use manifest_url instead. This is confusing to developers. Also it made developers unable to change their start_url and manifest_url.Having a stable id allows apps to update other metadata like start_url and manifest_url, and have a consistent way to reference apps across browser platforms, PWA stores and other external entities.This feature tracks the launch process for implementation on the desktop side, as the Android implementation will be done with a different timeline. They will both follow the same specification.

Standards & signals

Docs: https://docs.google.com/document/d/1f9xQR1msTxiYvzFguKMkqSfrXMo_cT2yvhCEM3SYIt0/edit?usp=sharing

Explainers: https://github.com/philloooo/pwa-unique-id/blob/main/explainer.md

View on chromestatus.com