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

css
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 of 100% changes the input completely to grayscale, while a value of 0% leaves the input unchanged. Values between 0% and 100% have linear multipliers on the effect. If the grayscale() filter is present with no parameter, the default value is 1. The initial value used for interpolation is 0.

Formal syntax

<grayscale()> = 
grayscale( [ <number> | <percentage> ]? )

Examples

Examples of correct values for grayscale()

css
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: