Code has been added to clipboard!

The CSS Background-Size Property

Reading time 1 min
Published Aug 10, 2017
Updated Oct 10, 2019

Explaining background-size

Using the background-size property, you can define a custom CSS background image size:

Example
div { 
  background: url(https://github.com/bitdegree/banners/blob/master/learn/pom-laptop.png?raw=true);
  background-size: 60px 90px;
}

The CSS background-size syntax

To use the CSS background-size property, follow the syntax example below:

background-size: value;

Example
div {
  background: url(https://cdn.bitdegree.org/learn/pom-laptop.png?raw=true);
  background-size: 30%;
}

You will find all the available values explained in the following section.

Property values

Value Description Example
auto The default value. The image is scaled, keeping the aspect ratio. background-size: auto;
cover The image covers the container fully, but might be stretched or cropped. background-size: cover;
contain The container fits all the image inside it, but some areas might be left uncovered. background-size: contain;
Length units Two values define the width and height, respectively. If you only define one, it stands for width, and the height is auto by default. background-size: 700px 500px;
Percentages Two values define the width and height in relation with the original CSS background image size. If you only define one, value it stands for width, and the height is auto by default. background-size: 30%;

Note: if you separate the values by commas, you can define the CSS background image size for multiple backgrounds.

Browser support

Chrome
3+
Edge
12+
Firefox
4+
IE
9+
Opera
10+
Safari
4.1+

Mobile browser support

Chrome
18+
Firefox
4+
Opera
10.1+
Safari
All
Tutorial
CSS3 Features
Syntax
Classes
ID Selectors
Attribute Selectors
Stylesheets
Inline
Internal
External
Box Model
Children Selectors
Pseudo Classes
Pseudo Elements
Variables
Counters
Text
Fonts
Web Fonts
Backgrounds
Background Images
Colors
Gradients
Opacity / Transparency
Shadow Effects
Transitions
Tooltip
Transform
Animations
Layout — Display
Layout — Position
Layout — Float
Layout — Clear
Layout — Horizontal & Vertical Align
Multiple Columns
Introduction
Responsive Web Design — Viewport
Responsive Web Design — Grid View
Responsive Web Design — Media Queries
Responsive Web Design — Flexbox Layout
Responsive Web Design — Images
Responsive Web Design — Videos
Borders
Margin
Padding
Width
Height
Outline
Links
Lists
Tables
Dropdown Menu
Navigation Bar
Images
Image Gallery
Border Images
Forms
Rounded Corners
Buttons
Box-Sizing
Selector Reference
Pagination Examples
Code Examples
CSS3 Browser Support Reference
Functions Reference
Speech Module Reference
Units
Web Safe Font Combinations
Cheat Sheet
:hover
@font-face
@keyframes
@media
align-content
align-items
align-self
all
animation
backface-visibility
background
background-clip
background-color
background-image
background-origin
background-position
background-size
border
border-image
border-radius
border-style
box-shadow
box-sizing
color
columns
filter
flex
flex-basis
flex-direction
flex-flow
flex-grow
flex-shrink
flex-wrap
font
font-family
font-size
font-size-adjust
font-stretch
font-style
font-weight
hanging-punctuation
justify-content
line-height
margin
offset
opacity
order
outline
overflow
padding
perspective
position
resize
tab-size
text-align
text-decoration
text-emphasis
text-transform
text-shadow
transform
transition-property
translate
vertical-align
word-break
word-wrap
z-index