`scroll-margin-top` CSS property

Baseline Widely available

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

See full compatibility

The scroll-margin-top property defines the top margin of the scroll snap area that is used for snapping this box to the snapport. The scroll snap area is determined by taking the transformed border box, finding its rectangular bounding box (axis-aligned in the scroll container's coordinate space), then adding the specified outsets.

Try it

scroll-margin-top: 0;

scroll-margin-top: 20px;

scroll-margin-top: 2em;

<section class="default-example" id="default-example">
  <div class="scroller">
    <div>1</div>
    <div id="example-element">2</div>
    <div>3</div>
  </div>
  <div class="info">Scroll »</div>
</section>

.default-example .info {
  inline-size: 100%;
  padding: 0.5em 0;
  font-size: 90%;
  writing-mode: vertical-rl;
}

.scroller {
  text-align: left;
  height: 250px;
  width: 270px;
  overflow-y: scroll;
  display: flex;
  flex-direction: column;
  box-sizing: border-box;
  border: 1px solid black;
  scroll-snap-type: y mandatory;
}

.scroller > div {
  flex: 0 0 250px;
  background-color: rebeccapurple;
  color: white;
  font-size: 30px;
  display: flex;
  align-items: center;
  justify-content: center;
  scroll-snap-align: start;
}

.scroller > div:nth-child(even) {
  background-color: white;
  color: rebeccapurple;
}

Syntax

css

/* <length> values */
scroll-margin-top: 10px;
scroll-margin-top: 1em;

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

Values

<length>: An outset from the top edge of the scroll container.

Formal definition

Initial value	`0`
Applies to	all elements
Inherited	no
Computed value	as specified
Animation type	by computed value type

Formal syntax

scroll-margin-top = 
  <length>

Specifications

Specification
CSS Scroll Snap Module Level 1 # margin-longhands-physical

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`scroll-margin-top`	Chrome – Full support Chrome 69 (Release date: 2018-09-04) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – Full support Firefox 68 (Release date: 2019-07-09) footnote Full support	Opera – Full support Opera 56 (Release date: 2018-09-25) footnote Full support	Safari – Partial support Safari 11 (Release date: 2017-09-19) altname footnote Partial support altname Alternate name: scroll-snap-margin-top footnote Before version 14.1, scroll margin is not applied for scrolls to fragment target or `scrollIntoView()`, see bug 189265. Safari – Full support Safari 14.1 (Release date: 2021-04-26) footnote Full support	Chrome Android – Full support Chrome Android 69 (Release date: 2018-09-04) footnote Full support	Firefox for Android – Full support Firefox for Android 68 (Release date: 2019-07-09) footnote Full support	Opera Android – Full support Opera Android 48 (Release date: 2018-11-08) footnote Full support	Safari on iOS – Partial support Safari on iOS 11 (Release date: 2017-09-19) altname footnote Partial support altname Alternate name: scroll-snap-margin-top footnote Before version 14.5, scroll margin is not applied for scrolls to fragment target or `scrollIntoView()`, see bug 189265. Safari on iOS – Full support Safari on iOS 14.5 (Release date: 2021-04-26) footnote Full support	Samsung Internet – Full support Samsung Internet 10 (Release date: 2019-08-22) footnote Full support	WebView Android – Full support WebView Android 69 (Release date: 2018-09-04) footnote Full support	WebView on iOS – Partial support WebView on iOS 11 (Release date: 2017-09-19) altname footnote Partial support altname Alternate name: scroll-snap-margin-top footnote Before version 14.5, scroll margin is not applied for scrolls to fragment target or `scrollIntoView()`, see bug 189265. WebView on iOS – Full support WebView on iOS 14.5 (Release date: 2021-04-26) footnote Full support

Tip: you can click/tap on a cell for more information.

Full support: Full support
Partial support: Partial support
: Uses a non-standard name
: Has more compatibility info.

scroll-margin-top CSS property

Legend

`scroll-margin-top` CSS property