background-position-x

The background-position-x CSS property sets the initial horizontal position for each background image. The position is relative to the position layer set by background-origin.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

The value of this property is overridden by any declaration of the background or background-position shorthand properties applied to the element after it.

Syntax

/* Keyword values */
background-position-x: left;
background-position-x: center;
background-position-x: right;

/* <percentage> values */
background-position-x: 25%;

/* <length> values */
background-position-x: 0px;
background-position-x: 1cm;
background-position-x: 8em;

/* Side-relative values */
background-position-x: right 3px;
background-position-x: left 25%;

/* Multiple values */
background-position-x: 0px, center;

/* Global values */
background-position-x: inherit;
background-position-x: initial;
background-position-x: unset;

The background-position-x property is specified as one or more values, separated by commas.

Values

left

Aligns the left edge of the background image with the left edge of the background position layer.

center

Aligns the center of the background image with the center of the background position layer.

right

Aligns the right edge of the background image with the right edge of the background position layer.

<length>

The offset of the given background image's horizontal edge from the corresponding background position layer's horizontal edge. If no edge is given, it refers to the left edge.

<percentage>

The offset of the given background image's horizontal edge from the corresponding background position layer's horizontal edge relative to its width. If no edge is given, it refers to the left edge by default.

Formal syntax

[ center | [ left | right | x-start | x-end ]? <length-percentage>? ]#
where 
<length-percentage> = <length> | <percentage>

Specifications

Browser compatibility

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

See also

• background-position
• background-position-y
• background-position-inline
• background-position-block
• Using multiple backgrounds