grayscale()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
The grayscale()
CSS function converts the input image to grayscale. Its result is a <filter-function>
.
Try it
Syntax
grayscale(amount)
Parameters
amount
-
Amount of the input image that is converted to grayscale. It is specified as a
<number>
or a<percentage>
. A value of100%
changes the input completely to grayscale, while a value of0%
leaves the input unchanged. Values between0%
and100%
have linear multipliers on the effect. If thegrayscale()
filter is present with no parameter, the default value is1
. The initial value used for interpolation is0
.
Formal syntax
Examples
Examples of correct values for grayscale()
grayscale(0) /* No effect */
grayscale(.7) /* 70% grayscale */
grayscale(100%) /* Completely grayscale */
Specifications
Specification |
---|
Filter Effects Module Level 1 # funcdef-filter-grayscale |
Browser compatibility
BCD tables only load in the browser
See also
The other <filter-function>
functions available to be used in values of the filter
and backdrop-filter
properties include: