coderef

background-imageBaseline · Widely available

The background-image CSS property sets the graphics to display behind the content of an element and in front of the background color. Graphics may be any combination of images or gradients.

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.

Browser support

DesktopChrome
1+Supportedsince Dec 11, 2008
Current: 155
Edge
12+Supportedsince Jul 29, 2015
Current: 154
Firefox
1–3.5Not supported
3.6+Supportedsince Jan 21, 2010
Current: 157
Safari
1–1.2Not supported
1.3+Supportedsince Apr 15, 2005
Current: 27
MobileChrome Android
18+Supportedsince Jun 27, 2012
Current: 155
Firefox Android
4+Supportedsince Mar 29, 2011
Current: 157
Safari iOS
1+Supportedsince Jun 29, 2007
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-image.

Feature detection

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

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

Sub-features

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

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
background-image112111841
background-image.multiple_backgrounds1123.61.31841
background-image.none112111841