Back to Content

padding

files/en-us/web/css/reference/properties/padding/index.md

latest4.3 KB
Original Source

The padding CSS shorthand property sets the padding area on all four sides of an element at once.

{{InteractiveExample("CSS Demo: padding")}}

css
padding: 1em;
css
padding: 10% 0;
css
padding: 10px 50px 20px;
css
padding: 10px 50px 30px 0;
css
padding: 0;
html
<section id="default-example">
  <div class="transition-all" id="example-element">
    <div class="box">
      Far out in the uncharted backwaters of the unfashionable end of the
      western spiral arm of the Galaxy lies a small unregarded yellow sun.
    </div>
  </div>
</section>
css
#example-element {
  border: 10px solid #ffc129;
  overflow: hidden;
  text-align: left;
}

.box {
  border: dashed 1px;
}

An element's padding area is the space between its content and its border.

[!NOTE] Padding creates extra space within an element. In contrast, {{cssxref("margin")}} creates extra space around an element.

Constituent properties

This property is a shorthand for the following CSS properties:

  • {{cssxref("padding-top")}}
  • {{cssxref("padding-right")}}
  • {{cssxref("padding-bottom")}}
  • {{cssxref("padding-left")}}

Syntax

css
/* Apply to all four sides */
padding: 1em;

/* top and bottom | left and right */
padding: 5% 10%;

/* top | left and right | bottom */
padding: 1em 2em 2em;

/* top | right | bottom | left */
padding: 5px 1em 0 2em;

/* Global values */
padding: inherit;
padding: initial;
padding: revert;
padding: revert-layer;
padding: unset;

The padding property may be specified using one, two, three, or four values. Each value is a {{cssxref("<length>")}} or a {{cssxref("<percentage>")}}. Negative values are invalid.

  • When one value is specified, it applies the same padding to all four sides.
  • When two values are specified, the first padding applies to the top and bottom, the second to the left and right.
  • When three values are specified, the first padding applies to the top, the second to the right and left, the third to the bottom.
  • When four values are specified, the paddings apply to the top, right, bottom, and left in that order (clockwise).

Values

  • {{cssxref("<length>")}}
    • : The size of the padding as a fixed value.
  • {{cssxref("<percentage>")}}
    • : The size of the padding as a percentage, relative to the inline size (width in a horizontal language, defined by {{cssxref("writing-mode")}}) of the containing block.

Formal definition

{{cssinfo}}

Formal syntax

{{csssyntax}}

Examples

Setting padding with pixels

HTML

html
<h4>This element has moderate padding.</h4>
<h3>The padding is huge in this element!</h3>

CSS

css
h4 {
  background-color: lime;
  padding: 20px 50px;
}

h3 {
  background-color: cyan;
  padding: 110px 50px 50px 110px;
}

Result

{{EmbedLiveSample('Setting_padding_with_pixels', '100%', 300)}}

Setting padding with pixels and percentages

css
padding: 5%; /* All sides: 5% padding */

padding: 10px; /* All sides: 10px padding */

padding: 10px 20px; /* top and bottom: 10px padding */
/* left and right: 20px padding */

padding: 10px 3% 20px; /* top:            10px padding */
/* left and right: 3% padding   */
/* bottom:         20px padding */

padding: 1em 3px 30px 5px; /* top:    1em padding  */
/* right:  3px padding  */
/* bottom: 30px padding */
/* left:   5px padding  */

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{cssxref("padding-top")}}, {{cssxref("padding-right")}}, {{cssxref("padding-bottom")}}, and {{cssxref("padding-left")}}
  • {{cssxref("padding-block-start")}}, {{cssxref("padding-block-end")}}, {{cssxref("padding-inline-start")}}, and {{cssxref("padding-inline-end")}}
  • {{cssxref("padding-block")}} and {{cssxref("padding-inline")}} shorthands
  • Introduction to the CSS box model guide
  • CSS box model module