Skip to Content
Platform.Ontology

Window Controls Overlay and Tabbed mode

Lets an installed app draw into the title bar, or show tabs.

Works without askingHome screen and system linksWindowWeb browsersWhile you use it

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

BrowserStatusFirst versionReleasedNote
ChromeSupported892021-03-02None
EdgeSupported892021-03-04None
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidNot supportedNot availableNot listedNone
Samsung InternetNot supportedNot availableNot listedNone

How a site asks for it

APImanifest display_override: ['window-controls-overlay','tabbed']
Browser compat keysmanifests.webapp.display_override
How access is grantedinstall
What the user seesNone
Needs a secure context (HTTPS)Yes
Needs a user gestureNo
How long it lastsPer origin
How to take it backSite settings
Inside an iframeSame as top level; cross-origin iframes need a permissions policy where listed

Typical flow

  1. Call the API
  2. Browser applies its access rules
  3. 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

FieldTypeUnitRangePrecision
titlebarAreaRectobjectpixelsx,y,width,heightNot 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

TypeExampleApps
productivityA web design app puts its toolbar in the title bar, which gives the canvas more space.Figma
messagingA chat app puts its search box in the title bar, like a native chat app.Slack
musicA web music player shows now playing in the top strip.None named
developerA web code editor shows tabs in the title bar to save room.VS Code for the Web
gamesA web game launcher uses the full window with its logo in the title bar.None named
creativeA web video editor shows the project name and tools in the top strip.None named
enterpriseA company dashboard app shows alerts in the title bar.None named

Risks

  • Only installed apps
  • Can hide window controls

What the platform says

Good uses and abuse

Legitimate uses

  • Custom title bars

Known abuse

  • None

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility2 of 5How useful it is to honest apps
Friction1 of 5How much the user has to do
Fingerprint bitsNot ratedRough 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.

On this page