grayscale()
{{CSSRef}}
The grayscale()
CSS function converts the input image to grayscale. Its result is a {{cssxref("<filter-function>")}}
.
{{InteractiveExample("CSS Demo: grayscale()")}}
filter: grayscale(0);
filter: grayscale(0.2);
filter: grayscale(60%);
filter: grayscale(1);
<section id="default-example">
<img
class="transition-all"
id="example-element"
src="/shared-assets/images/examples/firefox-logo.svg"
width="200" />
</section>
Syntax
grayscale(amount)
Parameters
amount
{{Optional_Inline}}
- : Amount of the input image that is converted to grayscale. It is specified as a
{{cssxref("<number>")}}
or a{{cssxref("<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. The initial value used for{{Glossary("interpolation")}}
is0
. The default value is1
.
- : Amount of the input image that is converted to grayscale. It is specified as a
Formal syntax
{{CSSSyntax}}
Examples
Examples of correct values for grayscale()
grayscale(0) /* No effect */
grayscale(.7) /* 70% grayscale */
grayscale() /* Completely grayscale */
grayscale(1)
grayscale(100%)
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
The other {{cssxref("<filter-function>")}}
functions available to be used in values of the {{cssxref("filter")}}
and {{cssxref("backdrop-filter")}}
properties include:
{{cssxref("filter-function/blur", "blur()")}}
{{cssxref("filter-function/brightness", "brightness()")}}
{{cssxref("filter-function/contrast", "contrast()")}}
{{cssxref("filter-function/drop-shadow", "drop-shadow()")}}
{{cssxref("filter-function/hue-rotate", "hue-rotate()")}}
{{cssxref("filter-function/invert", "invert()")}}
{{cssxref("filter-function/opacity", "opacity()")}}
{{cssxref("filter-function/saturate", "saturate()")}}
{{cssxref("filter-function/sepia", "sepia()")}}