Before you start
Who can use this feature
Anyone on any team or plan
Anyone with edit access to a file can use masks.
Use masks to show specific areas of objects while concealing the rest.
It's like placing a photograph inside a picture frame with a small opening. You'll see a portion of the photograph peeking through the opening, while the rest is concealed without the need to trim it down to size.
Since no portion of masked layers are modified or deleted in this process, masks are a non-destructive action. This allows you to preserve the concealed areas without the need to trim them down to fit.
How masks work
Any layer can be used as a mask, including vector shapes, text layers, images with transparency channels, groups, and more.
In Figma, masks are positioned below any layers you want to mask.
When you use a layer as a mask, a mask object is created, which includes the mask and any layers it is masking. The mask is then applied to all the siblings above it in on the z-index until it reaches:
- Another mask or mask object
- The mask's parent frame or group
- A frame or component with clip content on
In the Layers panel, a mask object can be identified by a at the base and an upward-facing arrow. Layers being masked will appear above the mask. The arrow that extends from the mask shows which layers are included in that mask object.
Opacity and alpha channels
All masks in Figma support alpha channels. Alpha channels represent the degree of transparency, or opacity, in a color, image, or object.
Instead of using the outline of a layer or image to determine what's visible, alpha masks take into account the opacity of the mask.
This means we can utilize blurs and opacity in our masks:
- Import existing PNGs, GIFs, and WebP files with transparency (alpha channels)
- Use layer blur effects to replicate feathering
- Apply drop and inner shadows to create depth
- Add fills, strokes, and gradients with varying opacity
When working with alpha masks, masks are applied based on the opacity of the mask. Portions of the mask with an opacity greater than 0% will reveal the layers it is masking. Parts of the mask with an opacity of 0%, or no fill at all, will hide the layers it is masking.
In the example above, we've used an ellipse with an outside stroke as our mask. The opacity of the ellipse's fill is 100% and the opacity of the stroke is 30%. More of the content is revealed in the center of the image, where the mask's opacity is higher (100%).
Create a mask
Masks must contain a fill with an opacity of more than 0% for effects and masked objects to show.
- Select an object you want to use as your mask.
- Choose any of the following methods to turn the object into a mask:
- Click in the top toolbar
- Right-click the object and select Use as mask
- Use the keyboard shortcut:
- Once the mask object is created, place any objects you want to be masked above the mask layer. You can do this by clicking and dragging them from the Layers panel of the left sidebar.
You can also select multiple objects and apply a mask. Doing this will use the bottom-most object as a mask. Selecting some siblings but not others will place the mask object into a group.
Note: If you use an object on the canvas as a mask, Figma will place the newly created mask object in a group.
Edit a mask
Resize and reposition
Resizing a mask won't resize any layers it is masking, and vice versa. The same is true for repositioning masks and layers it is masking.
Because they are siblings of one another, masks won't have any parenting behavior that a frame, group, or component might have. Thus, the contents of a mask object move and resize independently from one another.
Apply properties to a mask
Masks are "invisible" on the canvas. Any properties — like stroke, fills, or effects — added to a mask layer are treated as masks as well.
Figma recognizes transparency levels for masks, so you can adjust the opacity according to how much you want the masked objects to show through.
Remove a mask
To stop using an object as a mask, use any of the following methods to toggle it off:
- Select the mask and click in the top toolbar
- Right-click the mask and select Use as mask.
- Select the mask and use the keyboard shortcut:
- Mac: ⌃ Control ⌘ Command M
- Windows: Ctrl Alt M
Any portions hidden by the mask will reappear.
Reveal mask outlines
By default, Figma does not show the boundaries of a mask. Use mask outlines when working with complex masks or to check for unintended empty spaces.
To see them, toggle on/off mask outlines:
- Open the Figma menu
- Go to View
- Click Mask outlines
If you toggle on this setting on, the masks in your file will be outlined in green.
You can also search "show mask outlines" using quick actions.
Note: If all layers being masked are hidden or have 0% opacity, then the object's mask outlines won't appear.
Use shape outlines to ignore transparency
Use shape outlines allows you to ignore the transparency of a mask's fill or stroke and the alpha transparency of an image. Instead, it uses the outline of its shape as the mask, and assumes 100% opacity.
- Select a mask with transparency, or an alpha channel.
- Check/uncheck Use shape outlines in the Mask section of the right sidebar.
Note: Using shape outlines doesn't work on layer opacity or opacity from effects.