scroll-margin

The scroll-margin shorthand property sets all of the scroll margins of an element at once, assigning values much like the margin property does for margins of an element.

Constituent properties

This property is a shorthand for the following CSS properties:

Syntax

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

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

Values

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

Description

You can see the effect of scroll-margin by scrolling to a point partway between two of the "pages" of the example's content. The value specified for scroll-margin determines how much of the page that's primarily outside the snapport should remain visible.

Thus, 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.

Formal definition

Initial value0
Applies toall elements
Inheritedno
Computed valueas specified
Animation typeby computed value type

Formal syntax

<length>{1,4}

Specifications

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

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
scroll-marginChrome Full support 69Edge Full support 79Firefox Full support 68IE No support NoOpera Full support 56Safari Partial support 11
Notes Alternate Name
Partial support 11
Notes Alternate Name
Notes Scroll margin is not applied for scrolls to fragment target or scrollIntoView(), see bug 189265.
Alternate Name Uses the non-standard name: scroll-snap-margin
WebView Android Full support 69Chrome Android Full support 69Firefox Android Full support 68Opera Android Full support 48Safari iOS Partial support 11
Notes Alternate Name
Partial support 11
Notes Alternate Name
Notes Scroll margin is not applied for scrolls to fragment target or scrollIntoView(), see bug 189265.
Alternate Name Uses the non-standard name: scroll-snap-margin
Samsung Internet Android Full support 10.0

Legend

Full support  
Full support
Partial support  
Partial support
No support  
No support
See implementation notes.
See implementation notes.
Uses a non-standard name.
Uses a non-standard name.