clip

The clip CSS property defines a visible portion of an element. The clip property applies only to absolutely positioned elements — that is, elements with position:absolute or position:fixed.

/* Keyword value */
clip: auto;

/* <shape> values */
clip: rect(1px 10em 3rem 2ch);
clip: rect(1px, 10em, 3rem, 2ch);

/* Global values */
clip: inherit;
clip: initial;
clip: unset;

Syntax

Note: Where possible, authors are encouraged to use the newer clip-path property instead.

Values

<<shape>()>
A rectangular <<shape>()> of the form rect(<top> <right> <bottom> <left>). The <top> and <bottom> values are offsets from the inside top border edge of the box, while <right> and <left> are offsets from the inside left border edge of the box — that is, the extent of the padding box.
The <top>, <right>, <bottom>, and <left> values may be either a <length> or auto. If any side's value is auto, the element is clipped to that side's inside border edge.
auto
The element does not clip (default). This is different from rect(auto, auto, auto, auto), which clips to the element’s inside border edges.

Formal definition

Initial valueauto
Applies toabsolutely positioned elements
Inheritedno
Computed valueauto if specified as auto, otherwise a rectangle with four values, each of which is auto if specified as auto or the computed length otherwise
Animation typea rectangle

Formal syntax

<shape> | auto

where
<shape> = rect(<top>, <right>, <bottom>, <left>)

Examples

Clipping an image

CSS

.dotted-border {
  border: dotted;
  position: relative;
  width: 536px;
  height: 350px;
}

#top-left,
#middle,
#bottom-right {
  position: absolute;
  top: 0;
}

#top-left {
  left: 360px;
  clip: rect(0 175px 113px 0);
}


#middle {
  left: 280px;
  clip: rect(119px 255px 229px 80px);
}

#bottom-right {
  left: 200px;
  clip: rect(235px 335px 345px 160px);
}

HTML

<p class="dotted-border">
  <img src="https://udn.realityripple.com/samples/8f/15174f3500.jpg" title="Original graphic">
  <img id="top-left" src="https://udn.realityripple.com/samples/8f/15174f3500.jpg" title="Graphic clipped to upper left">
  <img id="middle" src="https://udn.realityripple.com/samples/8f/15174f3500.jpg" title="Graphic clipped towards middle">
  <img id="bottom-right" src="https://udn.realityripple.com/samples/8f/15174f3500.jpg" title="Graphic clipped to bottom right">
</p>

Result

Specifications

Specification Status Comment
CSS Masking Module Level 1
The definition of 'clip' in that specification.
Candidate Recommendation Deprecates clip property, suggests clip-path as replacement.
CSS Level 2 (Revision 1)
The definition of 'clip' in that specification.
Recommendation Initial definition.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
clip
Deprecated
Chrome Full support 1Edge Full support 12Firefox Full support 1IE Full support 4
Notes
Full support 4
Notes
Notes Before Internet Explorer 7, Internet Explorer incorrectly interprets clip: auto as clip: rect(auto, auto, auto, auto).
Opera Full support 7Safari Full support 1
Notes
Full support 1
Notes
Notes Safari incorrectly interprets clip: auto as clip: rect(auto, auto, auto, auto).
WebView Android Full support 37Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support 14Safari iOS Full support 1
Notes
Full support 1
Notes
Notes Safari incorrectly interprets clip: auto as clip: rect(auto, auto, auto, auto).
Samsung Internet Android Full support 1.0

Legend

Full support
Full support
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.
See implementation notes.
See implementation notes.

See also