1. Effects
  2. mask-position

Effects

mask-position

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

ClassStyles
mask-top-left
mask-position: top left;
mask-top
mask-position: top;
mask-top-right
mask-position: top right;
mask-left
mask-position: left;
mask-center
mask-position: center;
mask-right
mask-position: right;
mask-bottom-left
mask-position: bottom left;
mask-bottom
mask-position: bottom;
mask-bottom-right
mask-position: bottom right;
mask-position-(<custom-property>)
mask-position: var(<custom-property>);
mask-position-[<value>]
mask-position: <value>;

Examples

Basic example

Use utilities like mask-center, mask-right, and mask-left-top to control the position of an element's mask image:

mask-top-left

mask-top

mask-top-right

mask-left

mask-center

mask-right

mask-bottom-left

mask-bottom

mask-bottom-right

<div class="mask-top-left mask-[url(/img/circle.png)] mask-size-[50%] bg-[url(/img/mountains.jpg)] ..."></div>
<div class="mask-top mask-[url(/img/circle.png)] mask-size-[50%] bg-[url(/img/mountains.jpg)] ..."></div>
<div class="mask-top-right mask-[url(/img/circle.png)] mask-size-[50%] bg-[url(/img/mountains.jpg)] ..."></div>
<div class="mask-left mask-[url(/img/circle.png)] mask-size-[50%] bg-[url(/img/mountains.jpg)] ..."></div>
<div class="mask-center mask-[url(/img/circle.png)] mask-size-[50%] bg-[url(/img/mountains.jpg)] ..."></div>
<div class="mask-right mask-[url(/img/circle.png)] mask-size-[50%] bg-[url(/img/mountains.jpg)] ..."></div>
<div class="mask-bottom-left mask-[url(/img/circle.png)] mask-size-[50%] bg-[url(/img/mountains.jpg)] ..."></div>
<div class="mask-bottom mask-[url(/img/circle.png)] mask-size-[50%] bg-[url(/img/mountains.jpg)] ..."></div>
<div class="mask-bottom-right mask-[url(/img/circle.png)] mask-size-[50%] bg-[url(/img/mountains.jpg)] ..."></div>

Using a custom value

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

<div class="mask-position-[center_top_1rem] ...">
<!-- ... -->
</div>

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

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

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

Responsive design

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

<div class="mask-center md:mask-top ...">
<!-- ... -->
</div>

Learn more about using variants in the variants documentation.

Copyright © 2025 Tailwind Labs Inc.·Trademark Policy