← Back to release summary

Window Management: Accurate Screen Labels

Category
Device
Type
Chromium catches up
Status
Enabled by default (Chrome 105)
Intent stage
Shipped

Summary

Enhances screen label strings provided by the Window Management API: <https://chromestatus.com/feature/5252960583942144> This launch refines the `ScreenDetailed.label` implementation by replacing the current placeholder values (e.g. 'External Display 1') with data sourced from display device EDIDs (e.g. 'HP Z27n') and higher-level OS APIs (e.g. localized descriptions such as 'Built-in Retina Display'). These more accurate labels match those shown by OSes in display settings UI surfaces. The labels are only exposed to sites which have been granted the window-management permission by the user. This revised implementation aligns with the current attribute specification <https://w3c.github.io/window-management/#screen-label> and definitions used for the M93-M96 Origin Trial and the M100 API launch. There is no structural change to the API, only a change in the string content returned by the `ScreenDetailed.label` attribute.

Motivation

Multi-Screen Window Placement API partners have requested this change to provide more recognizable and user-friendly entries in screen selection interfaces.

Standards & signals

Docs: https://docs.google.com/document/d/11DlNwb0LIsuekeL5JC3Puc-IK8OmOWfmb8b_yzfp3Ss/edit?resourcekey=0-gjUuuifqnrd1KMqQ9JX3tw

Samples: https://michaelwasserman.github.io/window-placement-demo

Explainers: https://github.com/w3c/window-placement/blob/main/EXPLAINER.md#:~:text=DOMString%20label

View on chromestatus.com