Source: https://tailwindcss.com/docs/mask-size

v4.1

Effects
mask-size

Effects

mask-size

Utilities for controlling the size of an element's mask image.

| Class | Styles | | --- | --- | | mask-auto | mask-size: auto; | | mask-cover | mask-size: cover; | | mask-contain | mask-size: contain; | | mask-size-(<custom-property>) | mask-size: var(<custom-property>); | | mask-size-[<value>] | mask-size: <value>; |

Examples

Filling the container

Use the mask-cover utility to scale the mask image until it fills the mask layer, cropping the image if needed:

<div class="mask-cover mask-[url(/img/scribble.png)] bg-[url(/img/mountains.jpg)] ..."></div>

Filling without cropping

Use the mask-contain utility to scale the mask image to the outer edges without cropping or stretching:

<div class="mask-contain mask-[url(/img/scribble.png)] bg-[url(/img/mountains.jpg)] ..."></div>

Using the default size

Use the mask-auto utility to display the mask image at its default size:

<div class="mask-auto mask-[url(/img/scribble.png)] bg-[url(/img/mountains.jpg)] ..."></div>

Using a custom value

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

<div class="mask-size-[auto_100px] ...">  <!-- ... --></div>

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

<div class="mask-size-(--my-mask-size) ...">  <!-- ... --></div>

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

Responsive design

Prefix a mask-size utility with a breakpoint variant like md: to only apply the utility at medium screen sizes and above:

<div class="mask-auto md:mask-contain ...">  <!-- ... --></div>

Learn more about using variants in the variants documentation .

📄 tailwindcss/docs/mask-size