Skip to content

CSS background-clip Property

The CSS background-clip property defines the area to which the background-color and background-image are painted. If the element has no background-color or background-image, this property has no visual effect.

The background-clip property is one of the CSS3 properties.

For clipping a background to text, a vendor-prefixed version (-webkit-background-clip) is also available.

Initial Valueborder-box
Applies toAll elements. It also applies to ::first-letter and ::first-line.
InheritedNo.
AnimatableNo.
VersionCSS3
DOM Syntaxobject.style.backgroundClip = "content-box";

Syntax

Syntax of CSS background-clip Property

css
background-clip: border-box | padding-box | content-box | text | initial | inherit;

Example of the background-clip property:

Example of CSS background-clip Property with content-box value

html
<!DOCTYPE html>
<html>
  <head>
    <title>The title of the document</title>
    <style>
      #example {
        border: 3px solid #666;
        padding: 15px;
        background: #ccc;
        background-clip: content-box;
      }
    </style>
  </head>
  <body>
    <h2>Background-clip property example</h2>
    <p>Here the "content-box" value is used.</p>
    <div id="example">
      <p>The background extends to the edge of the content box.</p>
    </div>
  </body>
</html>

In the following example find the difference between the "padding-box" and the "border-box" values.

Example of the background-clip property with the "padding-box" and "border-box" values:

Example of CSS background-clip Property with border-box value

html
<!DOCTYPE html>
<html>
  <head>
    <title>The title of the document</title>
    <style>
      #example1 {
        border: 5px dashed #666;
        padding: 15px;
        background: #1c87c9;
        background-clip: border-box;
      }
      #example2 {
        border: 5px dashed #666;
        padding: 15px;
        background: #1c87c9;
        background-clip: padding-box;
      }
    </style>
  </head>
  <body>
    <h2>Background-clip property example</h2>
    <p>Here the background-clip is set to "border-box" (this is the default value).</p>
    <div id="example1">
      <p>The background extends behind the border.</p>
    </div>
    <p>Here the background-clip is set to "padding-box".</p>
    <div id="example2">
      <p>The background extends to the inside edge of the border.</p>
    </div>
  </body>
</html>

In this example, the background is painted within the foreground text.

CSS background-clip Property

Example of the background-clip property with the "text" value:

Example of CSS background-clip Property with text value

html
<!DOCTYPE html>
<html>
  <head>
    <title>The title of the document</title>
    <style>
      #example {
        border: 3px dashed #1ebf42;
        padding: 15px;
        background: #1c87c9;
        background-clip: text;
        -webkit-background-clip: text;
        color: transparent;
      }
    </style>
  </head>
  <body>
    <h2>Background-clip property example</h2>
    <p>Here the background-clip is set to "text"</p>
    <div id="example">
      <p>The background is painted within the foreground text.</p>
    </div>
  </body>
</html>

Values

ValueDescriptionPlay it
border-boxThe background appears behind the border. This is the default value.Play it »
padding-boxThe background appears inside of the border.Play it »
content-boxThe background extends to the edge of the content box.Play it »
textThe background is painted within the foreground text.Play it »
initialSets the property to its default value.Play it »
inheritInherits the property from its parent element.

Practice

Which of the following values can be used with the 'background-clip' property in CSS?

Dual-run preview — compare with live Symfony routes.