CSS mask-image Property Reference

The CSS mask-image property is a standard property in CSS Masking. Review its formal syntax, computed behavior, and practical declarations.

Updated 2026-08-12

mask-image overview

The CSS mask-image property is a standard property in CSS Masking. Review its formal syntax, computed behavior, and practical declarations.

The property is not inherited by default. Use an explicit global keyword when inheritance is intended.

Syntax and formal definition

mask-image formal syntax

Field	Value
Formal syntax	<mask-reference>#
Initial value	none
Applies to	allElementsSVGContainerElements
Inherited	No
Percentages	no
Computed value	asSpecifiedURLsAbsolute
Animation type	discrete
Media	visual
Specification group	CSS Masking
Status	Standard

Practical examples

These declarations demonstrate valid ways to set mask-image. The initial and inherit global keywords remain available even when a property-specific value is preferable.

mask-image live example

CSS

.reset-example {
  mask-image: initial;
}

.inherit-example {
  mask-image: inherit;
}

@supports (mask-image: initial) {
  .supported {
    mask-image: initial;
  }
}