📄 tailwindcss/docs/backdrop-filter-grayscale
File: backdrop-filter-grayscale.md | Updated: 11/15/2025
Source: https://tailwindcss.com/docs/backdrop-filter-grayscale
⌘KCtrl KDocs Blog Showcase Sponsor Plus
- Filters
- grayscale
Filters
backdrop-filter: grayscale()
Utilities for applying backdrop grayscale filters to an element.
| Class | Styles |
| --- | --- |
| backdrop-grayscale | backdrop-filter: grayscale(100%); |
| backdrop-grayscale-<number> | backdrop-filter: grayscale(<number>%); |
| backdrop-grayscale-(<custom-property>) | backdrop-filter: grayscale(var(<custom-property>)); |
| backdrop-grayscale-[<value>] | backdrop-filter: grayscale(<value>); |
Basic example
Use utilities like backdrop-grayscale-50 and backdrop-grayscale to control the grayscale effect applied to an element's backdrop:
backdrop-grayscale-0
backdrop-grayscale-50
backdrop-grayscale
<div class="bg-[url(/img/mountains.jpg)]"> <div class="bg-white/30 backdrop-grayscale-0 ..."></div></div><div class="bg-[url(/img/mountains.jpg)]"> <div class="bg-white/30 backdrop-grayscale-50 ..."></div></div><div class="bg-[url(/img/mountains.jpg)]"> <div class="bg-white/30 backdrop-grayscale-200 ..."></div></div>
Using a custom value
Use the backdrop-grayscale-[<value>] syntax to set the backdrop grayscale based on a completely custom value:
<div class="backdrop-grayscale-[0.5] ..."> <!-- ... --></div>
For CSS variables, you can also use the backdrop-grayscale-(<custom-property>) syntax:
<div class="backdrop-grayscale-(--my-backdrop-grayscale) ..."> <!-- ... --></div>
This is just a shorthand for backdrop-grayscale-[var(<custom-property>)] that adds the var() function for you automatically.
Responsive design
Prefix a backdrop-filter: grayscale() utility with a breakpoint variant like md: to only apply the utility at medium screen sizes and above:
<div class="backdrop-grayscale md:backdrop-grayscale-0 ..."> <!-- ... --></div>
Learn more about using variants in the variants documentation .
On this page
Copyright © 2025 Tailwind Labs Inc.·Trademark Policy