Display refresh rate and HDR
Reads the screen refresh rate and HDR support with no prompt.
In one line
Can see your screen refresh rate and whether it shows HDR, with no prompt
Reads the screen refresh rate and HDR support with no prompt.
60, 90, 120 or 144 Hz plus HDR format list separates device tiers and models. Used for animation pacing.
What it can and can't do
What the user does: Nothing. Games and video apps check when they start
It can
- See the refresh rate, such as 60, 90, 120 or 144 Hz
- See which refresh rate options your screen supports on Android
- See if the screen supports HDR on Android
- See if an iPhone has a 120 Hz ProMotion screen
It cannot
- Change the screen's hardware refresh options
- Force a rate your screen does not support
- Tell who you are from the screen alone
How it differs between platforms: Android lists many refresh modes. iPhone shows 60 or 120 Hz, with ProMotion on Pro models since 2021.
On Android and iPhone
| Android | iPhone | |
|---|---|---|
| Status | Supported | Supported |
| First version | Android 6.0 (API 23) | iOS 10.3 |
| Permission or entitlement | Not listed | none |
| Protection level | none | none |
| How access is granted | none | none |
| What the user sees | Not listed | Not listed |
| How long it lasts | Not listed | Not listed |
| How to take it back | Not listed | Not listed |
| Store policy | None listed | None listed |
| API | Display.getRefreshRate(), getSupportedModes() (API 23), getHdrCapabilities() (API 24) | 60 or 120 Hz (ProMotion); ProMotion on Pro models since 2021 |
| Notes | Rates 60, 90, 120, 144 Hz | None |
Data you get
What comes back: Refresh rate, HDR types
Shape: object
How often: Static or on mode change
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
refresh_hz | float | Hz | 60 to 144 | 0.1 Hz |
Technical limits
- Low entropy
The story
What it is
An app can see how fast your screen redraws and whether it supports HDR.
For you
You see smoother scrolling and games on a fast screen. The app also learns whether your phone has a 60, 90, 120 or 144 Hz display, which shows the phone tier.
For makers
Makers match animation speed to the screen and decide whether to offer HDR video. The mix of rate and HDR formats helps separate phone models for fingerprinting.
Where you see it
| Type | Example | Apps |
|---|---|---|
| games | A racing game offers a 120 frames per second mode only on phones that can show it. | None named |
| video | A streaming app plays HDR movies only if your screen supports the format. | Netflix |
| creative | A drawing app matches pen lag to the screen speed so strokes feel instant. | None named |
| social | A feed app speeds up scrolling animations on a 120 Hz display. | None named |
| ar-vr | An AR app picks a target frame rate that matches the camera and screen. | None named |
| ads | An ad firm uses refresh rate and HDR formats to tell similar phones apart. | None named |
Risks
- Reveals phone tier
- Adds to a fingerprint
Android and iPhone in short
- Android: Reads the display modes and HDR list with no prompt.
- iPhone: Reads the maximum frame rate and HDR support with no prompt.
What the platform says
- Google: Frame rate on Android. Developer guide: let your app choose a frame rate that fits the display for smooth motion and better battery life.
Good uses and abuse
Legitimate uses
- Smooth animation
Known abuse
- Fingerprint
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 2 of 5 | How useful it is to honest apps |
| Friction | 0 of 5 | How much the user has to do |
| Fingerprint bits | 2 | Rough identifying entropy, when known |
History
- 2015-10, Android 6.0 (API 23): Display modes list exposed
Related capabilities
Related
- Screen size and density. Can see your screen size, sharpness and scale, with no prompt
Same idea on the web
- Display refresh rate (measured). Can estimate your screen's refresh rate by timing about one second of animation
Sources
How well checked: Based on official documentation.