Filters

filter: blur()

Utilities for applying blur filters to an element.

ClassStyles
blur-xs
filter: blur(var(--blur-xs)); /* 4px */
blur-sm
filter: blur(var(--blur-sm)); /* 8px */
blur-md
filter: blur(var(--blur-md)); /* 12px */
blur-lg
filter: blur(var(--blur-lg)); /* 16px */
blur-xl
filter: blur(var(--blur-xl)); /* 24px */
blur-2xl
filter: blur(var(--blur-2xl)); /* 40px */
blur-3xl
filter: blur(var(--blur-3xl)); /* 64px */
blur-none
filter: ;
blur-(<custom-property>)
filter: blur(var(<custom-property>));
blur-[<value>]
filter: blur(<value>);

Examples

Basic example

Use utilities like blur-sm and blur-lg to blur an element:

blur-none

blur-sm

blur-lg

blur-2xl

<img class="blur-none" src="/img/mountains.jpg" /><img class="blur-sm" src="/img/mountains.jpg" /><img class="blur-lg" src="/img/mountains.jpg" /><img class="blur-2xl" src="/img/mountains.jpg" />

Using a custom value

Use the blur-[<value>] syntax to set the blur based on a completely custom value:

<img class="blur-[2px] ..." src="/img/mountains.jpg" />

For CSS variables, you can also use the blur-(<custom-property>) syntax:

<img class="blur-(--my-blur) ..." src="/img/mountains.jpg" />

This is just a shorthand for blur-[var(<custom-property>)] that adds the var() function for you automatically.

Responsive design

Prefix a filter: blur() utility with a breakpoint variant like md: to only apply the utility at medium screen sizes and above:

<img class="blur-none md:blur-lg ..." src="/img/mountains.jpg" />

Learn more about using variants in the variants documentation.

Customizing your theme

Use the --blur-* theme variables to customize the blur utilities in your project:

@theme {  --blur-2xs: 2px; }

Now the blur-2xs utility can be used in your markup:

<img class="blur-2xs" src="/img/mountains.jpg" />

Learn more about customizing your theme in the theme documentation.

Copyright © 2025 Tailwind Labs Inc.·Trademark Policy

Tailwind CSS 中文网(本网站)的目标是为中文开发者提供准确、及时的 Tailwind CSS 中文文档

Tailwind CSS 中文文档由本网站维护人员共同翻译,采用 MIT 开源协议发布

本网站与 tailwindcss.com 及 Tailwind Labs Inc. 并无从属关系

Tailwind 商标由 Tailwind Labs Inc. 所有

京ICP备15031610号-8