MDN self-hosted library · e01.org

`margin-top` CSS property

The margin-top CSS property sets the margin area on the top of an element. A positive value places it farther from its neighbors, while a negative value places it closer.

no runnable cells css-property upstream source

The margin-top CSS property sets the margin area on the top of an element. A positive value places it farther from its neighbors, while a negative value places it closer.

This property has no effect on non-replaced inline elements, such as span or code.

CSS Demo: margin-top

```css interactive-example-choice margin-top: 1em;


```css interactive-example-choice
margin-top: 10%;

```css interactive-example-choice margin-top: 10px;


```css interactive-example-choice
margin-top: 0;

```html interactive-example


```css interactive-example
#container {
  width: 300px;
  height: 200px;
  display: flex;
  align-content: flex-start;
  flex-direction: column;
  justify-content: flex-start;
}

.row {
  height: 33.33%;
  display: inline-block;
  border: solid #ce7777 10px;
  background-color: #2b3a55;
  flex-shrink: 0;
}

#example-element {
  border: solid 10px #ffbf00;
  background-color: #2b3a55;
}

Syntax

/* <length> values */
margin-top: 10px; /* An absolute length */
margin-top: 1em; /* relative to the text size */
margin-top: 5%; /* relative to the nearest block container's width */
margin-top: anchor-size(height);
margin-top: calc(anchor-size(--my-anchor self-inline, 25px) / 4);

/* Keyword value */
margin-top: auto;

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

The margin-top property is specified as the keyword auto, or a <length>, or a <percentage>. Its value can be positive, zero, or negative.

Values

  • <length>
  • : The size of the margin as a fixed value.

  • <percentage>

  • : The size of the margin as a percentage, relative to the inline size (width in a horizontal language, defined by writing-mode) of the containing block.
  • auto
  • : The browser selects a suitable value to use. See margin.

Formal definition

Formal syntax

Examples

Setting positive and negative top margins

.content {
  margin-top: 5%;
}
.side-box {
  margin-top: 10px;
}
.logo {
  margin-top: -5px;
}
#footer {
  margin-top: 1em;
}

Specifications

Browser compatibility

See also

  • margin-right, margin-bottom, and margin-left
  • margin shorthand
  • margin-block-start, margin-block-end, margin-inline-start, and margin-inline-end
  • margin-block and margin-inline shorthands
  • CSS box model module