📄 tailwindcss/docs/mask-origin

File: mask-origin.md | Updated: 11/15/2025

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

v4.1

⌘KCtrl KDocs Blog Showcase Sponsor Plus

  1. Effects
  2. mask-origin

Effects

mask-origin

Utilities for controlling how an element's mask image is positioned relative to borders, padding, and content.

| Class | Styles | | --- | --- | | mask-origin-border | mask-origin: border-box; | | mask-origin-padding | mask-origin: padding-box; | | mask-origin-content | mask-origin: content-box; | | mask-origin-fill | mask-origin: fill-box; | | mask-origin-stroke | mask-origin: stroke-box; | | mask-origin-view | mask-origin: view-box; |

Examples


Basic example

Use utilities like mask-origin-border, mask-origin-padding, and mask-origin-content to control where an element's mask is rendered:

mask-origin-border

mask-origin-padding

mask-origin-content

<div class="mask-origin-border border-3 p-1.5 mask-[url(/img/circle.png)] bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-origin-padding border-3 p-1.5 mask-[url(/img/circle.png)] bg-[url(/img/mountains.jpg)] ..."></div><div class="mask-origin-content border-3 p-1.5 mask-[url(/img/circle.png)] bg-[url(/img/mountains.jpg)] ..."></div>

Responsive design

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

<div class="mask-origin-border md:mask-origin-padding ...">  <!-- ... --></div>

Learn more about using variants in the variants documentation .

On this page

[Refactoring UI

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