Window Management (multi-screen)
Asks to see all connected monitors and place windows on them.
In one line
Can see all your connected screens and place windows on them, if you allow
Asks to see all connected monitors and place windows on them.
Reveals how many screens you have, their sizes, positions, labels and scale. That is a strong device fingerprint and lets a site open fullscreen windows on a chosen monitor.
What it can and can't do
What the user does: You click Use all screens or Present on second monitor, then Allow.
It can
- List your screens with their size and position
- Open windows on the screen you choose
- Go fullscreen on a chosen monitor
- Tell that more than one screen is attached, without asking you
It cannot
- List your screens before you click Allow
- See your windows from other apps
- Work in Firefox or Safari
How it differs between platforms: Chrome and Edge on computers only. Firefox and Safari do not have it.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 100 | 2022-03-29 | Window Management API ships as window-placement in 100, renamed in 111 |
| Edge | Supported | 100 | 2022-04-01 | None |
| Firefox | Not supported | Not available | Not listed | None |
| Safari | Not supported | Not available | Not listed | None |
| Safari on iPhone | Not supported | Not available | Not listed | None |
| Chrome on Android | Supported | 100 | 2022-03-29 | None |
| Samsung Internet | Not supported | Not available | Not listed | None |
How a site asks for it
| API | window.getScreenDetails(); screen.isExtended; ScreenDetails.screens; screenschange event |
| Permission name | window-management |
| Permissions policy | window-management |
| Browser compat keys | api.Window.getScreenDetailsapi.Screen.isExtended |
| How access is granted | prompt |
| What the user sees | Chrome prompt: Manage windows on all your displays, Allow or Block. screen.isExtended is readable without a prompt. |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | Persistent per origin |
| How to take it back | Site settings; Permissions API window-management |
| Inside an iframe | Needs allow="window-management" in iframes |
Typical flow
- Check screen.isExtended (no prompt)
- Call getScreenDetails() from a gesture
- Permission prompt
- Read ScreenDetailed objects
- Open or fullscreen on a chosen screen
Data you get
What comes back: ScreenDetails with one ScreenDetailed per monitor
Shape: object
How often: on call plus change events
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
isExtended | boolean | none | true or false | 1 bit, no prompt |
width/height/availWidth/availHeight | integer | pixels | per screen | about 10 bits per value |
left/top/availLeft/availTop | integer | pixels | may be negative | reveals layout |
devicePixelRatio | float | ratio | about 1 to 4 | few bits |
label | string | text | monitor name | high entropy |
isPrimary/isInternal | boolean | none | true or false | 1 bit each |
colorDepth | integer | bits | 24 or 30 | 1 bit |
Technical limits
- Chromium desktop only
- Requires a gesture
- Fullscreen on chosen screen still needs a gesture
The story
What it is
Asks to see all your connected monitors and place windows on them.
For you
Your browser asks, 'Manage windows on all your displays?' If you say yes, the site can open its own windows on each screen, like speaker notes on one and slides on another.
For makers
It lets web apps compete with desktop apps in setups with many screens. It also reveals your layout of monitors, so browsers ask first.
Where you see it
| Type | Example | Apps |
|---|---|---|
| productivity | A slide app puts the presentation on the projector and speaker notes on your laptop screen. | Google Slides |
| games | A browser flight or racing game opens a map, dashboard or chat on a second monitor. | None named |
| enterprise | A trading or operations dashboard opens charts across several monitors in one click. | None named |
| creative | A video or music editor in the browser puts the timeline on one screen and the preview on another. | None named |
| live | A web control room for live events opens one window per camera on a wall of screens. | None named |
| security | A security camera web page opens many feeds across a monitor wall. | None named |
| education | A lecture tool shows slides to students and notes to the teacher. | None named |
Risks
- Reveals monitor layout
- Can scatter windows
What the platform says
- Chrome: Window Management API. Chrome says it lets web apps see and use multiple screens, for example presentations across displays.
Good uses and abuse
Legitimate uses
- Presentation tools
- Trading and control rooms
Known abuse
- Multi-monitor fingerprint
- Placing fullscreen pages over other windows
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 3 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 2 of 5 | How much the user has to do |
| Fingerprint bits | 6 | Rough identifying entropy, when known |
History
- 2022-03, Chrome 100: Window Placement API ships as window-placement permission
- 2023-03, Chrome 111: Renamed Window Management, permission name window-management
Related capabilities
Related
- Fullscreen API. Can fill your whole screen after you tap, with a clear way out
Sources
How well checked: Based on official documentation.