Skip to Content
Platform.Ontology

dynamic-range and video-dynamic-range

Whether the screen can show HDR.

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

In one line

Can check whether your screen can show HDR bright and dark detail

Whether the screen can show HDR.

Tells a site to serve HDR video. Splits users into standard and HDR displays (modern iPhones, MacBook Pro, HDR monitors).

What it can and can't do

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

It can

  • Ask whether your screen supports high dynamic range
  • Serve HDR video or images if it does
  • Add the answer to a browser fingerprint

It cannot

  • See your screen's exact brightness
  • Learn your monitor model
  • Turn HDR on or off

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported982022-02-01None
EdgeSupported982022-02-03None
FirefoxSupported1002022-05-03None
SafariSupported13.12020-03-24None
Safari on iPhoneSupported13.42020-03-24None
Chrome on AndroidSupported982022-02-01None
Samsung InternetSupported18.02022-08-08None

How a site asks for it

APImatchMedia('(dynamic-range: high)')
Browser compat keyscss.at-rules.media.dynamic-range
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
dynamic-range and video-dynamic-rangeenumNonestandard, highNot listed

The story

What it is

Asks whether your screen can show high dynamic range, the very bright and very dark picture look called HDR.

For you

You never get asked. If your screen supports HDR, a video may look brighter with deeper shadows. If not, you get the normal version without noticing.

For makers

Streaming sites avoid sending big HDR files to screens that cannot show them. That saves money. HDR also lets brands pitch a premium look.

Where you see it

TypeExampleApps
videoA streaming site sends HDR video only to screens that can show it, and plain video to the rest.Netflix, YouTube
gamesA cloud gaming site turns on HDR streaming for a supported laptop screen.Xbox Cloud Gaming, GeForce NOW
creativeA photo or video editor in the browser enables an HDR preview when the screen supports it.None named
adsA brand uses an extra bright HDR ad on screens that can show it.None named
shoppingA TV or phone seller shows HDR product videos only to screens that can display them.None named
analyticsA team learns how many viewers can see HDR before paying to produce it.None named

Risks

  • Small fingerprint clue
  • Reveals device class

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 bits1Rough identifying entropy, when known

Sources

How well checked: Based on official documentation.

On this page