CSS grayscale()

christian.dinh's avatar
Published Jul 12, 2021Updated Dec 9, 2023
Contribute to Docs

Converts an element to grayscale.

  • Front-end engineers work closely with designers to make websites beautiful, functional, and fast.
    • Includes 34 Courses
    • With Professional Certification
    • Beginner Friendly.
      115 hours
  • A full-stack engineer can get a project done from start to finish, back-end to front-end.
    • Includes 51 Courses
    • With Professional Certification
    • Beginner Friendly.
      150 hours

Syntax

filter: grayscale(<value>);

where a required <value> can be one of the following:

  • Number value: 0, .4
  • Percentage value: 100%, 50%

Note: Values of 0 and 0% will leave the image unchanged. Values of 1 and 100% will convert the image to complete grayscale. If a value is omitted, the default value is 1.

Example 1

Give the image a grayscale of 20%:

.banner-image {
filter: grayscale(20%);
}

Comparison between a original image and the image with the grayscale filter

The first image on the left is the original, and the image on the right has the grayscale filter set at (20%).

All contributors

Contribute to Docs

Learn CSS on Codecademy

  • Front-end engineers work closely with designers to make websites beautiful, functional, and fast.
    • Includes 34 Courses
    • With Professional Certification
    • Beginner Friendly.
      115 hours
  • A full-stack engineer can get a project done from start to finish, back-end to front-end.
    • Includes 51 Courses
    • With Professional Certification
    • Beginner Friendly.
      150 hours