margin-block

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

/* <length> values */
margin-block: 10px 20px;  /* An absolute length */
margin-block: 1em 2em;    /* relative to the text size */
margin-block: 5% 2%;      /* relative to the nearest block container's width */
margin-block: 10px;       /* sets both start and end values */

/* Keyword values */
margin-block: auto;

/* Global values */
margin-block: inherit;
margin-block: initial;
margin-block: revert;
margin-block: unset;

This property corresponds to the margin-top and margin-bottom, or the margin-right and margin-left properties, depending on the values defined for writing-mode, direction, and text-orientation.

This property is a shorthand for the following CSS properties:

• margin-block-start
• margin-block-end

The margin-block property may be specified using one or two values.

• When one value is specified, it applies the same margin to both start and end.
• When two values are specified, the first margin applies to the start, the second to the end.

The margin-block property takes the same values as the margin property.

<'margin-left'>{1,2}

CSS

div {
  background-color: yellow;
  width: 120px;
  height: auto;
  border: 1px solid green;
}

p {
  margin: 0;
  margin-block: 20px 40px;
  background-color: tan;
}

.verticalExample {
  writing-mode: vertical-rl;
}

HTML

<div>
  <p>Example text</p>
</div>
<div class="verticalExample">
  <p>Example text</p>
</div>

Result

• The mapped physical properties: margin-top, margin-right, margin-bottom, and margin-left
• writing-mode, direction, text-orientation