Window Controls Overlay and Tabbed mode
Lets an installed app draw into the title bar, or show tabs.
In one line
Can draw into the title bar of an installed app, like showing tabs or search
Lets an installed app draw into the title bar, or show tabs.
Customises the app window chrome on desktop.
What it can and can't do
What the user does: You install the web app on a computer and open it
It can
- Place buttons or a search box in the title bar of the app window
- Draw tabs there
- Keep the system's close and minimize buttons
It cannot
- Work for a site that is not installed
- Hide the close, minimize or maximize buttons
- Work in Firefox, Safari or on phones
- See anything outside its own window
How it differs between platforms: Chrome and Edge on computers only. Phones, Safari and Firefox do not support it.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 89 | 2021-03-02 | None |
| Edge | Supported | 89 | 2021-03-04 | 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 | Not supported | Not available | Not listed | None |
| Samsung Internet | Not supported | Not available | Not listed | None |
How a site asks for it
| API | manifest display_override: ['window-controls-overlay','tabbed'] |
| Browser compat keys | manifests.webapp.display_override |
| How access is granted | install |
| What the user sees | None |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | No |
| How long it lasts | Per origin |
| How to take it back | Site settings |
| Inside an iframe | Same as top level; cross-origin iframes need a permissions policy where listed |
Typical flow
- Call the API
- Browser applies its access rules
- Page receives the result
Data you get
What comes back: Lets an installed app draw into the title bar, or show tabs.
Shape: object
How often: on demand
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
titlebarAreaRect | object | pixels | x,y,width,height | Not listed |
Technical limits
- Desktop Chromium only
- Installed PWA
The story
What it is
An installed desktop web app can draw its own design in the title bar, or show tabs there.
For you
The app uses the whole window, with its search bar or tabs in the top strip. It looks more like a real desktop program. Window buttons still work as usual.
For makers
Makers get a premium look and more space for tools. It helps web apps match desktop apps for design. It is used for polish, and only works for installed apps on desktop.
Where you see it
| Type | Example | Apps |
|---|---|---|
| productivity | A web design app puts its toolbar in the title bar, which gives the canvas more space. | Figma |
| messaging | A chat app puts its search box in the title bar, like a native chat app. | Slack |
| music | A web music player shows now playing in the top strip. | None named |
| developer | A web code editor shows tabs in the title bar to save room. | VS Code for the Web |
| games | A web game launcher uses the full window with its logo in the title bar. | None named |
| creative | A web video editor shows the project name and tools in the top strip. | None named |
| enterprise | A company dashboard app shows alerts in the title bar. | None named |
Risks
- Only installed apps
- Can hide window controls
What the platform says
- Google Chrome: Window Controls Overlay. Lets installed web apps use the full window, including the title bar area, so they look like desktop apps.
Good uses and abuse
Legitimate uses
- Custom title bars
Known abuse
- None
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 2 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
- 2022-05, Chrome 105: Window Controls Overlay
- 2024-06, Chrome 126: Tabbed mode
Sources
How well checked: Checked against real behavior.