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

v4.1

⌘KCtrl KDocs Blog Showcase Sponsor Plus

1. Effects
2. mask-composite

Effects

mask-composite

Utilities for controlling how multiple masks are combined together.

| Class | Styles | | --- | --- | | mask-add | mask-composite: add; | | mask-subtract | mask-composite: subtract; | | mask-intersect | mask-composite: intersect; | | mask-exclude | mask-composite: exclude; |

Examples

---

Basic example

Use utilities like mask-add and mask-intersect to control how an element's masks are combined together:

mask-add

mask-subtract

mask-intersect

mask-exclude

<div class="mask-add mask-[url(/img/circle.png),url(/img/circle.png)] mask-[position:30%_50%,70%_50%] bg-[url(/img/mountains.jpg)]"></div><div class="mask-subtract mask-[url(/img/circle.png),url(/img/circle.png)] mask-[position:30%_50%,70%_50%] bg-[url(/img/mountains.jpg)]"></div><div class="mask-intersect mask-[url(/img/circle.png),url(/img/circle.png)] mask-[position:30%_50%,70%_50%] bg-[url(/img/mountains.jpg)]"></div><div class="mask-exclude mask-[url(/img/circle.png),url(/img/circle.png)] mask-[position:30%_50%,70%_50%] bg-[url(/img/mountains.jpg)]"></div>

Responsive design

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

<div class="mask-add md:mask-subtract ...">  <!-- ... --></div>

Learn more about using variants in the variants documentation .

On this page

• Quick reference

• Examples

  • Basic example

  • Responsive design

[

From the creators of Tailwind CSS

Make your ideas look awesome, without relying on a designer.
\

“This is the survival kit I wish I had when I started building apps.”

Derrick Reimer, SavvyCal](https://www.refactoringui.com/?ref=sidebar)

Copyright © 2025 Tailwind Labs Inc.·Trademark Policy