CSS background-repeat Property
Example
Repeat a background-image only vertically:
body
{
background-image: url("paper.gif");
background-repeat: repeat-y;
}
Try it Yourself »
More "Try it Yourself" examples below.
Definition and Usage
The background-repeat property sets if/how a background image will be repeated.
By default, a background-image is repeated both vertically and horizontally.
Tip: The background image is placed according to the background-position property. If no background-position is specified, the image is always placed at the element's top left corner.
Default value: | repeat |
---|---|
Inherited: | no |
Animatable: | no. Read about animatable |
Version: | CSS1 |
JavaScript syntax: | object.style.backgroundRepeat="repeat-x" Try it |
Browser Support
The numbers in the table specify the first browser version that fully supports the property.
Property | |||||
---|---|---|---|---|---|
background-repeat | 1.0 | 4.0 | 1.0 | 1.0 | 3.5 |
Note: IE8 and earlier do not support multiple background images on one element.
CSS Syntax
background-repeat: repeat|repeat-x|repeat-y|no-repeat|initial|inherit;
Property Values
Value | Description | Play it |
---|---|---|
repeat | The background image will be repeated both vertically and horizontally. This is default | Play it » |
repeat-x | The background image will be repeated only horizontally | Play it » |
repeat-y | The background image will be repeated only vertically | Play it » |
no-repeat | The background-image will not be repeated | Play it » |
initial | Sets this property to its default value. Read about initial | Play it » |
inherit | Inherits this property from its parent element. Read about inherit |
More Examples
Example
How to repeat a background image both vertically and horizontally (default for background images):
body
{
background-image: url("paper.gif");
}
Try it Yourself »
Example
Repeat a background image only horizontally:
body
{
background-image: url("paper.gif");
background-repeat: repeat-x;
}
Try it Yourself »
Example
Display a background image only one time, with no-repeat:
body
{
background-image: url("paper.gif");
background-repeat: no-repeat;
}
Try it Yourself »
Related Pages
CSS tutorial: CSS Background
CSS reference: background-position property
HTML DOM reference: backgroundRepeat property