CSS background-position-y Property Reference

The CSS background-position-y property is a standard property in CSS Backgrounds and Borders. Review its formal syntax, computed behavior, and practical declarations.

Updated 2026-08-12

background-position-y overview

The CSS background-position-y property is a standard property in CSS Backgrounds and Borders. Review its formal syntax, computed behavior, and practical declarations.

The property is not inherited by default. Use an explicit global keyword when inheritance is intended.

Syntax and formal definition

background-position-y formal syntax

Field	Value
Formal syntax	[ center \| [ [ top \| bottom \| y-start \| y-end ]? <length-percentage>? ]! ]#
Initial value	0%
Applies to	allElements
Inherited	No
Percentages	referToHeightOfBackgroundPositioningAreaMinusBackgroundImageHeight
Computed value	listEachItemConsistingOfAbsoluteLengthPercentageAndOrigin
Animation type	repeatableList
Media	visual
Specification group	CSS Backgrounds and Borders
Status	Standard

Practical examples

These declarations demonstrate valid ways to set background-position-y. The initial and inherit global keywords remain available even when a property-specific value is preferable.

background-position-y live example

CSS

.reset-example {
  background-position-y: initial;
}

.inherit-example {
  background-position-y: inherit;
}

@supports (background-position-y: initial) {
  .supported {
    background-position-y: initial;
  }
}