padding-block-start

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

The padding-block-start CSS property defines the logical block start padding of an element, which maps to a physical padding depending on the element's writing mode, directionality, and text orientation.

Try it

Syntax

css
/* <length> values */
padding-block-start: 10px; /* An absolute length */
padding-block-start: 1em; /* A length relative to the text size */

/* <percentage> value */
padding-block-start: 5%; /* A padding relative to the block container's width */

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

Values

<length>

The size of the padding as a fixed value. Must be nonnegative.

<percentage>

The size of the padding as a percentage, relative to the inline-size (width in a horizontal language) of the containing block. Must be nonnegative.

Description

The padding-block-start property is defined in the specification as taking the same values as the padding-top property. However, the physical property it maps to depends on the values set for writing-mode, direction, and text-orientation. Therefore, it could map to padding-bottom, padding-right, or padding-left.

It relates to padding-block-end, padding-inline-start, and padding-inline-end, which define the other paddings of the element.

Formal definition

Initial value0
Applies toall elements, except table-row-group, table-header-group, table-footer-group, table-row, table-column-group and table-column
Inheritedno
Percentageslogical-width of containing block
Computed valueas <length>
Animation typea length

Formal syntax

padding-block-start = 
<'padding-top'>

<padding-top> =
<length-percentage [0,∞]>

<length-percentage> =
<length> |
<percentage>

Examples

Setting block start padding for vertical text

HTML

html
<div>
  <p class="exampleText">Example text</p>
</div>

CSS

css
div {
  background-color: yellow;
  width: 120px;
  height: 120px;
}

.exampleText {
  writing-mode: vertical-lr;
  padding-block-start: 20px;
  background-color: #c8c800;
}

Result

Specifications

Specification
CSS Logical Properties and Values Level 1
# padding-properties

Browser compatibility

BCD tables only load in the browser

See also