Custom media queriesLimited availability
The @custom-media CSS at-rule names a media query, which you can reuse in multiple @media rules.
Not yet supported in all major browsers — check the table and provide a fallback.
Browser support
DesktopChrome
✕Not supportedup to 155
Current: 155Edge
✕Not supportedup to 154
Current: 154Firefox
✕Not supportedup to 157
Current: 157Safari
✕Not supportedup to 27
Current: 27MobileChrome Android
✕Not supportedup to 155
Current: 155Firefox Android
✕Not supportedup to 157
Current: 157Safari iOS
✕Not supportedup to 27
Current: 27How to use
Not supported in Chrome, Edge, Firefox, Safari, Chrome Android, Firefox Android, Safari iOS. Use feature detection below and provide a fallback (or a polyfill) for those browsers.
Example
Full syntax and examples are on MDN: @custom-media.
Feature detection
JS · check before using
if ("CSSCustomMediaRule" in globalThis) {
// CSSCustomMediaRule is available
} else {
// load a polyfill or use a fallback
}Documentation (MDN)
Specification
Sub-features
Support for each part of the feature (2). The overall table above shows when the whole feature works.
| Sub-feature | Chrome | Edge | Firefox | Safari | Chrome Android | Firefox Android | Safari iOS |
|---|---|---|---|---|---|---|---|
| CSSCustomMediaRule | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |
| @custom-media | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ | ✕ |