The scroll-margin property is a shorthand property which sets all of the scroll-margin longhands, assigning values much like the margin property does for the margin-* longhands.

The scroll-margin values represent outsets defining 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.

Initial value 0
Applies to all elements
Inherited no
Media visual
Computed value as specified
Animation type by computed value type
Canonical order per grammar


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

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


An outset from the corresponding edge of the scroll container.

Formal syntax

[ auto | <length> ]{1,4}


Specification Status Comment
CSS Scroll Snap Module Level 1
The definition of 'scroll-margin' in that specification.
Candidate Recommendation Initial definition

Browser compatibility

No compatibility data found. Please contribute data for "css.properties.scroll-margin" (depth: 1) to the MDN compatibility data repository.

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.