coderef

background-sizeBaseline · Widely available

The background-size CSS property scales or stretches a background based on the size of the element (with the contain and cover keywords), a length, or percentage.

Supported in all major browsers for at least 30 months — safe to use without fallbacks. Baseline since Jul 29, 2015. Widely available since Jan 29, 2018.

How to use ↓Compare browsers

Browser support

DesktopChrome
1–20Not supported
21+Supportedsince Jul 31, 2012
Current: 155
Edge
12+Supportedsince Jul 29, 2015
Current: 154
Firefox
1–8Not supported
9+Supportedsince Dec 20, 2011
Current: 157
Safari
1–5Not supported
5.1+Supportedsince Jul 20, 2011
Current: 27
MobileChrome Android
18–18Not supported
25+Supportedsince Feb 27, 2013
Current: 155
Firefox Android
4–17Not supported
18+Supportedsince Jan 8, 2013
Current: 157
Safari iOS
1–4Not supported
4.2+Supportedsince Nov 22, 2010
Current: 27

How to use

This feature is Baseline widely available — use it freely, no fallback needed.

Example

Full syntax and examples are on MDN: background-size.

Feature detection

CSS · check before using
@supports (background-size: initial) {
  /* styles that rely on background-size */
}

/* or in JavaScript */
if (CSS.supports("background-size", "initial")) {
  // use it
}

Documentation (MDN)

Specification

Sub-features

Support for each part of the feature (5). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
background-size312451844.2
background-size.auto312451844.2
background-size.contain312451844.2
background-size.cover312451844.2
background.background-size211295.125184