coderef

Window Controls OverlayLimited availability

The display_override: ["window-controls-overlay"] web application manifest member shows content in the title bar area of a progressive web app that is installed on a desktop device.

Not yet supported in all major browsers — check the table and provide a fallback.

How to use ↓Compare browsers

Browser support

DesktopChrome
1–104Not supported
105+Supportedsince Sep 2, 2022
Current: 155
Edge
12–104Not supported
105+Supportedsince Sep 1, 2022
Current: 154
Firefox
✕Not supportedup to 157
Current: 157
Safari
✕Not supportedup to 27
Current: 27
MobileChrome Android
✕Not supportedup to 155
Current: 155
Firefox Android
✕Not supportedup to 157
Current: 157
Safari iOS
✕Not supportedup to 27
Current: 27

How to use

Not supported in Firefox, Safari, Chrome Android, Firefox Android, Safari iOS. Use feature detection below and provide a fallback (or a polyfill) for those browsers.

Example

Full syntax and examples are on MDN: windowControlsOverlay.

Feature detection

JS · check before using
if ("WindowControlsOverlay" in globalThis) {
  // WindowControlsOverlay is available
} else {
  // load a polyfill or use a fallback
}

Documentation (MDN)

Specification

Sub-features

Support for each part of the feature (15). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
Navigator.windowControlsOverlay105105✕✕✕✕✕
WindowControlsOverlay105105✕✕✕✕✕
WindowControlsOverlay.geometrychange_event105105✕✕✕✕✕
WindowControlsOverlay.getTitlebarAreaRect105105✕✕✕✕✕
WindowControlsOverlay.visible105105✕✕✕✕✕
WindowControlsOverlayGeometryChangeEvent105105✕✕✕✕✕
WindowControlsOverlayGeometryChangeEvent.WindowControlsOverlayGeometryChangeEvent105105✕✕✕✕✕
WindowControlsOverlayGeometryChangeEvent.titlebarAreaRect105105✕✕✕✕✕
WindowControlsOverlayGeometryChangeEvent.visible105105✕✕✕✕✕
@media.display-mode.window-controls-overlay105105✕✕✕✕✕
<env>.titlebar-area-height9393✕✕93✕✕
<env>.titlebar-area-width9393✕✕93✕✕
<env>.titlebar-area-x9393✕✕93✕✕
<env>.titlebar-area-y9393✕✕93✕✕
manifests.webapp.display_override.window-controls-overlay105105✕✕105✕✕