resolution media query
The resolution media query detects the output density of the device. It is useful for selecting sharper assets or adapting detail for high-density screens.
Overview
The resolution media query detects the output density of the device. It is useful for selecting sharper assets or adapting detail for high-density screens.
Browser support
| Feature | Desktop | Mobile | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 29 | 12 | 8 | 16 | 29 | 16 | |
| CSS at-rule | ||||||
| The resolution CSS media feature can be used to test the pixel density of the output device. | 29 | 12 | 8 | 16 | 29 | 16 |
| CSS type | ||||||
dpcm `dpcm` unit | 29 | 12 | 8 | 16 | 29 | 16 |
dpi `dpi` unit | 29 | 12 | 8 | 16 | 29 | 16 |
dppx `dppx` unit | 29 | 12 | 16 | 16 | 29 | 16 |
x `x` unit | 68 | 79 | 62 | 16 | 68 | 16 |
1+Supported (version) Not supported ※Has note Sub-feature descriptions sourced from MDN Web Docs (CC BY-SA 2.5)
Notes 3 item(s)
Limitation
- This browser only partially implements this feature
Removed
- This feature was removed in a later browser version (8)
Implementation note
- Supports `<integer>` values only.
Notes 3 item(s)
Limitation
- This browser only partially implements this feature
Removed
- This feature was removed in a later browser version (8)
Implementation note
- Supports `<integer>` values only.
Syntax
CSS
/* Displays with a resolution of 2x or higher */
@media (min-resolution: 2dppx) {
.logo {
background-image: url('logo@2x.png');
background-size: 200px 60px;
}
}
/* High resolution for printing */
@media print and (min-resolution: 300dpi) {
.chart {
background-image: url('chart-hires.png');
}
} Live demo
Use cases
Sharper visual assets
Serve denser imagery or refined decoration when display density makes the extra detail worthwhile.
Print and output tuning
Adjust styles for environments where output resolution changes the expected presentation.
Cautions
- Resolution alone does not tell you everything about screen size or reading distance.
- Prefer semantic responsive media features when they solve the asset problem more directly.
Accessibility
- Sharper assets can help readability, but text should remain real text whenever possible.
- Do not gate essential information behind image quality improvements that only some screens receive.
Related links
Powered by web-features