Skip to Content
Platform.Ontology

display-mode

How the page is shown: browser tab, standalone, fullscreen, PWA.

Gets silentlyScreen and windowsCSS media featuresWeb browsersWhen the page loadsWhile you use it

In one line

Can tell whether it is open in a browser tab, a home screen app or fullscreen

How the page is shown: browser tab, standalone, fullscreen, PWA.

Shows the app was installed as a PWA and whether the person runs it in a window. Useful for install analytics.

What it can and can't do

What the user does: Nothing. It happens when the page loads or the window changes.

It can

  • Check which display mode it is running in
  • Hide install buttons when it is already an app
  • Change its layout to fit app or tab

It cannot

  • See which other apps you have installed
  • Tell whether you also installed it on another device
  • Install itself without you choosing to

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported422015-04-14None
EdgeSupported792020-01-15None
FirefoxSupported472016-06-07None
SafariSupported132019-09-19None
Safari on iPhoneSupported12.22019-03-25None
Chrome on AndroidSupported422015-04-15None
Samsung InternetSupported4.02016-03-11None

How a site asks for it

APImatchMedia('(display-mode: standalone)')
Browser compat keyscss.at-rules.media.display-mode
How access is grantednone
What the user seesNone
Needs a secure context (HTTPS)No
Needs a user gestureNo
How long it lastsread fresh on every page load; nothing stored
How to take it backnone needed (no grant)
Inside an iframeReadable from cross-origin iframes too (same values)

Typical flow

  1. Page script reads the value
  2. No prompt is shown

Data you get

Shape: object
How often: static per session

FieldTypeUnitRangePrecision
display-modeenumNonebrowser, standalone, minimal-ui, fullscreen, window-controls-overlay, picture-in-pictureNot listed

The story

What it is

Tells a page whether it runs in a normal tab, as an installed app window, or full screen.

For you

You never see the check. But an app you installed from your browser may hide the address bar and show its own simple menu.

For makers

Makers change the layout for installed mode, hide the install prompt, and measure how many people install. Installed users usually come back more often, so it is a key business signal.

Where you see it

TypeExampleApps
productivityA to do app hides its 'Install' banner and shows a bottom tab bar once it runs as an installed app.None named
socialA social site counts how many daily users come from the installed version to see whether installs lift return visits.None named
gamesA browser game offers fullscreen play and landscape layout when launched from the home screen.None named
mediaA music or video site shows its own back button because the browser one is gone.None named
shoppingA store gives installed users a faster checkout and push notification offer.None named
analyticsA team tags installed sessions in analytics to compare them against tab visits.None named

Risks

  • Reveals app install status
  • Little else

What the platform says

Good uses and abuse

Legitimate uses

  • Respect OS theme and accessibility needs
  • Adapt layout

Known abuse

  • Infer disability or setting for fingerprinting

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits0.5Rough identifying entropy, when known

Sources

How well checked: Based on official documentation.

On this page