background-image property CSS Reference

Definition and Usage

The CSS background-image property sets one or several background images for an element. The images are drawn on successive stacking context layers, with the first specified being drawn as if it is the closest to the user. The borders of the element are then drawn on top of them, and the background-color is drawn beneath them.

How the images are drawn relative to the box and its borders is defined by the background-clip and background-origin CSS properties.

If a specified image cannot be drawn (for example when the file denoted by the specified URI cannot be loaded), browsers handle them as if it was the none value.

Note: Web developers should always specify a background-color, even if the images are opaque and the color won't be displayed in normal circumstances; if the images cannot be loaded - for instance, when the network is down - the background color will be used as a fallback.

• Initial none
• Applies to all elements
• Inherited no
• Media visual
• Computed Value as specified, but with URIs made absolute
• Animatable no
• Canonical order the unique non-ambiguous order defined by the formal grammar

Syntax

Formal syntax: <bg-image>#

background-image: none
background-image: url(http://www.example.com/images/bck.png)
background-image: inherit

Values

none

Is a keyword denoting the absence of images.

<image>

Is an <image> denoting the image to display. There can be several of them, separated by commas, as multiple backgrounds are supported.

Examples

body {
  background-image: url("images/darkpattern.png");
}
div {
  background-image: url("images/foo.png"), url("images/bar.png");
}
p {
  background-image: none;
}

Compatibility

Desktop browsers

Mobile browsers