dynamic-range and video-dynamic-range
Whether the screen can show HDR.
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
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 98 | 2022-02-01 | None |
| Edge | Supported | 98 | 2022-02-03 | None |
| Firefox | Supported | 100 | 2022-05-03 | None |
| Safari | Supported | 13.1 | 2020-03-24 | None |
| Safari on iPhone | Supported | 13.4 | 2020-03-24 | None |
| Chrome on Android | Supported | 98 | 2022-02-01 | None |
| Samsung Internet | Supported | 18.0 | 2022-08-08 | None |
How a site asks for it
| API | matchMedia('(dynamic-range: high)') |
| Browser compat keys | css.at-rules.media.dynamic-range |
| How access is granted | none |
| What the user sees | None |
| Needs a secure context (HTTPS) | No |
| Needs a user gesture | No |
| How long it lasts | read fresh on every page load; nothing stored |
| How to take it back | none needed (no grant) |
| Inside an iframe | Readable from cross-origin iframes too (same values) |
Typical flow
- Page script reads the value
- No prompt is shown
Data you get
Shape: object
How often: static per session
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
dynamic-range and video-dynamic-range | enum | None | standard, high | Not 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
| Type | Example | Apps |
|---|---|---|
| video | A streaming site sends HDR video only to screens that can show it, and plain video to the rest. | Netflix, YouTube |
| games | A cloud gaming site turns on HDR streaming for a supported laptop screen. | Xbox Cloud Gaming, GeForce NOW |
| creative | A photo or video editor in the browser enables an HDR preview when the screen supports it. | None named |
| ads | A brand uses an extra bright HDR ad on screens that can show it. | None named |
| shopping | A TV or phone seller shows HDR product videos only to screens that can display them. | None named |
| analytics | A 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
- MDN: dynamic-range media feature. Documents a media query that asks whether the screen and browser can show HDR content.
Good uses and abuse
Legitimate uses
- Respect OS theme and accessibility needs
- Adapt layout
Known abuse
- Infer disability or setting for fingerprinting
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 0 of 5 | How much the user has to do |
| Fingerprint bits | 1 | Rough identifying entropy, when known |
Related capabilities
Related
- Accessibility settings inferred. Can guess you may use accessibility settings by combining several browser signals
Sources
How well checked: Based on official documentation.