Layout & CSS More detail A2 · Formal specification Platform: Web

overscroll-behavior

`overscroll-behavior` controls what happens when a scrolling area reaches its edge. It can stop the scroll from continuing into a parent area and can change the edge effect.

See how it works
You might call it scroll chaining controlboundary behavior

See how it works

Original worked exampleoverscroll-behavior

Another example

A map tool has a long list of layers. `overscroll-behavior: contain` lets people scroll that list without moving the page behind it. The panel keeps its normal edge feedback. The main page scrolls normally after the pointer leaves the panel.

Main parts

  1. 01Nested scroller
  2. 02Scroll boundary
  3. 03Chaining policy

Use it when

Use `contain` at a planned inner scrolling edge, such as a map, drawer, or code editor.

Do not use it when

Do not turn off overscroll for the whole site. It may remove normal navigation and device feedback without fixing the layout.

Name used in code

overscroll-behavior: auto|contain|none

Before you ship

Check content order, shared design values, component consistency, contrast, zoom, and layout changes by screen size. Verify every theme, language, and state. If there is motion, offer an equal reduced-motion experience.

Request you can copy

Outcome: Use or define overscroll-behavior to make the visual experience clear and easy to use. User context: A map tool has a long list of layers. `overscroll-behavior: contain` lets people scroll that list without moving the page behind it. The panel keeps its normal edge feedback. The main page scrolls normally after the pointer leaves the panel. Design concept to apply: overscroll-behavior. Why it fits: Use `contain` at a planned inner scrolling edge, such as a map, drawer, or code editor. Do not use it when: Do not turn off overscroll for the whole site. It may remove normal navigation and device feedback without fixing the layout. Design requirements: Set the content order, shared design values, and reusable components. Define how the layout changes by screen size and state. Keep useful design choices separate from decoration. Inclusion and resilience: Check contrast, zoom, languages, themes, and reduced motion when needed. Do not use color or effects as the only way to show meaning. Acceptance criteria: The design stays clear on phones and desktops, at zoom, in every theme, and in all supported languages. Interactive states stay clear and consistent. Evidence and limits (evidence boundary): A formal document may still be a draft, release candidate, or final version. Check its status and browser or platform support. Unknowns to confirm: Brand limits, amount of content, supported themes and languages, target devices, and design-system rules.

Check this request

Review the current use of overscroll-behavior. Definition: `overscroll-behavior` controls what happens when a scrolling area reaches its edge. It can stop the scroll from continuing into a parent area and can change the edge effect. Release checks: Check content order, shared design values, component consistency, contrast, zoom, and layout changes by screen size. Verify every theme, language, and state. If there is motion, offer an equal reduced-motion experience. Before changing code, report the evidence you found, gaps, severity, and the smallest safe fix.

A2
How official is this term?

Formal specification

A published, versioned formal specification defines this term for the listed technical scope.

A formal document may still be a draft, release candidate, or final version. Check its status and browser or platform support.

Scope
CSS overscroll behavior
Document status
draft
Checked on
2026-07-30

Evidence sources & scope

Authority source + Term reference · W3C CSS Working Group · draft CSS Overscroll Behavior Module Level 1 — Overscroll behavior properties Overscroll behavior properties Scope: CSS scroll chaining and boundary behavior; direct scope: Overscroll behavior properties Role here: Direct term reference Source covers: canonical name, definition, semantics, implementation Authority source · W3C CSS Working Group · draft CSS Overscroll Behavior Module Level 1 Scope: CSS scroll chaining and boundary behavior Role here: Authority within stated scope Source covers: canonical name, definition, semantics, implementation

Copy it yourself

The browser could not copy this. Select the request below and copy it yourself.