Web/CSS/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: unset;

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

Constituent properties

This property is a shorthand for the following CSS properties:

Syntax

Values

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

Formal definition

Initial value	`0`
Applies to	same as `margin`
Inherited	no
Percentages	depends on layout model
Computed value	if specified as a length, the corresponding absolute length; if specified as a percentage, the specified value; otherwise, `auto`
Animation type	discrete

Formal syntax

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

Examples

Setting block start and end margins

HTML

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

CSS

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

.exampleText {
  writing-mode: vertical-rl;
  margin-block: 20px 40px;
  background-color: #c8c800;
}

Result

Specifications

Specification	Status	Comment
CSS Logical Properties and Values Level 1The definition of 'margin-block' in that specification.	Editor's Draft	Initial definition.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`margin-block`	Chrome Full support 69 Disabled' Full support 69 Disabled' Disabled' From version 69: this feature is behind the `Experimental Web Platform features` preference (needs to be set to `Enabled`). To change preferences in Chrome, visit chrome://flags.	Edge Full support 79 Disabled' Full support 79 Disabled' Disabled' From version 79: this feature is behind the `Experimental Web Platform features` preference (needs to be set to `Enabled`).	Firefox Full support 66	IE No support No	Opera Full support 56	Safari No support No	WebView Android Full support 69	Chrome Android Full support 69 Disabled' Full support 69 Disabled' Disabled' From version 69: this feature is behind the `Experimental Web Platform features` preference (needs to be set to `Enabled`). To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support 66	Opera Android Full support 48	Safari iOS No support No	Samsung Internet Android Full support 10.0

Legend

Full support: Full support
No support: No support
User must explicitly enable this feature.': User must explicitly enable this feature.