`-webkit-mask-position-y` CSS property
Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The -webkit-mask-position-y CSS property sets the initial vertical position of a mask image.
Syntax
/* Keyword values */ -webkit-mask-position-y: top; -webkit-mask-position-y: center; -webkit-mask-position-y: bottom; /* <percentage> values */ -webkit-mask-position-y: 100%; -webkit-mask-position-y: -50%; /* <length> values */ -webkit-mask-position-y: 50px; -webkit-mask-position-y: -1cm; /* Multiple values */ -webkit-mask-position-y: 50px, 25%, -3em; /* Global values */ -webkit-mask-position-y: inherit; -webkit-mask-position-y: initial; -webkit-mask-position-y: revert; -webkit-mask-position-y: revert-layer; -webkit-mask-position-y: unset;
Values
This property is specified as one or more comma-separated values:
-
<length-percentage> - A length indicating the position of the top side of the image relative to the box's top padding edge. Percentages are calculated against the vertical dimension of the box padding area. A value of
0%means the top edge of the image is aligned with the box's top padding edge and a value of100%means the bottom edge of the image is aligned with the box's bottom padding edge. -
top - Equivalent to
0%. -
bottom - Equivalent to
100%. -
center - Equivalent to
50%.
Formal definition
| Initial value | 0% |
|---|---|
| Applies to | all elements |
| Inherited | no |
| Percentages | refer to the size of the box itself |
| Computed value | for <length> the absolute value, otherwise a percentage |
| Animation type | discrete |
Formal syntax
-webkit-mask-position-y = [ <length-percentage> | top | center | bottom ]#
Examples
Vertically positioning a mask image
.exampleOne {
-webkit-mask-image: url("mask.png");
-webkit-mask-position-y: bottom;
}
.exampleTwo {
-webkit-mask-image: url("mask.png");
-webkit-mask-position-y: 25%;
}
Specifications
Not part of any standard.
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on iOS | Samsung Internet | WebView Android | WebView on iOS | |
-webkit-mask-position-y |
1 |
18 |
49 |
15 |
3.1 |
18 |
49 |
14 |
2 |
1.0 |
2 |
2 |
See also
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/-webkit-mask-position-y