PSA: Add "window-management" as an alias for permission and permission policy "window-placement"

Skip to first unread message

Brad Triebwasser

Jan 6, 2023, 9:02:23 AM1/6/23
to,,, Mike Wasserman

Hello blink-dev,

I would like to distribute this PSA for a pending change which introduces a new alias "window-management" for existing permission and permission-policy strings "window-placement". This is the first step of an effort to align with the spec definition and will lead to a deprecation and removal of the old one in a subsequent update after we observe via UMA metrics that developers have transitioned to the new strings.

Contact emails


Design docs


Adds "window-management" as an alias for "window-placement" permission and permission-policy strings. This is part of a larger effort to rename the strings by eventually deprecating and removing "window-placement". The terminology change improves the longevity of the descriptor as the Window Management API evolves over time.

Blink component


TAG review

N/A. No API surface or structure change here.

TAG review status

Not applicable


Interoperability and Compatibility

There are no compatibility risks. This change simply adds an alias for a permission.

Gecko: No signal

Firefox has not implemented the API and corresponding "window-placement" permission yet.

WebKit: No signal

Safari has not implemented the API and corresponding "window-placement" permission yet.

Web developers: We have communicated internally with partners using the API who have expressed commitment to updating the permission strings in their code.

Other signals: Positive comment from W3C WG Chair

WebView application risks

This is considered low risk. It adds an alias without any change in behavior of the underlying API.


There is no change in debuggability of the window management API with the new permission alias.

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

No, the permission is currently not supported on Android nor Android WebView

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


Flag name


Requires code in //chrome?


Tracking bug

Estimated milestones

DevTrial on desktop


Anticipated spec changes

The spec and permission registry have already been updated with the new permission strings.

Link to entry on the Chrome Platform Status

Reply all
Reply to author
0 new messages