background-origin

Published Jun 30, 2021Updated Oct 31, 2023
Contribute to Docs

Specifies the background positioning area of a background.

Syntax

Note: If the background-attachment is fixed, then background-origin will be ignored.

background-origin: <value>;

where <value> can be one of the following:

  • content-box: Relative positioning to the content box.
  • padding-box: Relative positioning to the padding box.
  • border-box: Relative positioning to the border box.
  • Global values: inherit, initial, revert, unset

Example 1

Set background positioning to the edge of the content box:

.main {
border: 5px dashed #4d4d4d;
padding: 1rem;
background: url(images/background-origin.jpg) no-repeat;
background-origin: content-box;
}

The resulting output of the code block above is:

Background origin set to padding-box

Example 2

Set background positioning to the inside edge of the border, respecting its padding:

.main {
border: 5px dashed #4d4d4d;
padding: 1rem;
background: url(images/background-origin.jpg) no-repeat;
background-origin: padding-box;
}

The resulting output of the code block above is:

Background origin set to padding-box

Example 3

Set background positioning to the edge of the border:

.main {
border: 5px dashed #4d4d4d;
padding: 1rem;
background: url(images/background-origin.jpg) no-repeat;
background-origin: border-box;
}

The resulting output of the code block above is:

Background origin set to padding-box

All contributors

Looking to contribute?

Learn CSS on Codecademy