Document Picture-in-Picture
Opens a small always-on-top window containing any HTML.
In one line
Can open a small floating window with its own content after you click
Opens a small always-on-top window containing any HTML.
Floats custom page content above other windows (video call controls, timers). A page can keep a floating surface visible while you work elsewhere, so it can also be abused for fake UI.
What it can and can't do
What the user does: You tap a button such as Pop out or Mini player.
It can
- Open a small always-on-top window with any page content, such as a timer, chat or video controls
- Keep it showing while you use other windows
- Update what it shows as time passes
It cannot
- Open it without a click, tap or keypress
- Hide which site it belongs to, since the window shows the site name
- Stop you from closing it
- Open it on phones or in Firefox and Safari
How it differs between platforms: Chrome and Edge on computers only. Firefox, Safari and phones do not have it.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 116 | 2023-08-15 | None |
| Edge | Supported | 116 | 2023-08-21 | 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 | 116 | 2023-08-15 | BCD lists no support; agent research says otherwise |
| Samsung Internet | Not supported | Not available | Not listed | None |
How a site asks for it
| API | documentPictureInPicture.requestWindow({width,height}); window.documentPictureInPicture.window |
| Permissions policy | picture-in-picture |
| Browser compat keys | api.DocumentPictureInPicture |
| How access is granted | gesture |
| What the user sees | No prompt; needs a gesture. The floating window shows the origin and is closable. |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | Until closed |
| How to take it back | Close the window |
| Inside an iframe | Needs allow="picture-in-picture" |
Typical flow
- Click
- documentPictureInPicture.requestWindow()
- Browser opens a floating window
- Move DOM into pipWindow.document
Data you get
What comes back: Floating window handle
Shape: none
How often: while open
No individual data fields. The signal is the access itself.
Technical limits
- Chromium desktop only
- One window per tab
The story
What it is
Opens a small always on top window that can hold any page content, not just video.
For you
A small window floats above your other apps. It may show a video call, a game, a timer or notes. It stays while you work in another tab.
For makers
It keeps people inside the product when they switch tasks. A video call or a game keeps going on screen. That means longer sessions and fewer missed moments.
Where you see it
| Type | Example | Apps |
|---|---|---|
| video | A video call keeps the faces and the mute button in a small floating window while you open a spreadsheet. | Google Meet |
| games | A browser puzzle or trivia game floats the timer and question while you read notes in another tab. | None named |
| live | A live sports score and chat float over your work so you can follow a match. | None named |
| productivity | A timer or a notes box floats over every tab while you work. | None named |
| media | A music site pops out the playlist and controls, not only a video frame. | None named |
| ads | An ad supported video player keeps a small window open so it keeps getting watch time. | None named |
| education | A language app keeps flashcards floating beside a lecture video. | None named |
Risks
- Can distract or cover content
- Chromium desktop only
What the platform says
- Chrome: Document Picture-in-Picture. Chrome says it lets sites pop out any content into an always on top window, like video calls or timers.
Good uses and abuse
Legitimate uses
- Video calls
- Notes and timers
Known abuse
- Always visible fake prompts
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 2 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 1 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2023-08, Chrome 116: Document Picture-in-Picture ships
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.