# CSS Scroll Snap: Smooth, Precise Scrolling for Carousels and Panels
Source: https://devdocs10.com/articles/css/css-scroll-snap
By Murat Bo · Published 2026-09-09 · DevDocs10 (https://devdocs10.com)
CSS Scroll Snap lets you define positions where scrolling should settle, so users can move through content in clean, controlled steps. It is especially useful for carousels, story-like panels, product galleries, and full-page sections that should align neatly after a scroll gesture.
> **Quick answer:** Use `scroll-snap-type` on the scrolling container and `scroll-snap-align` on the items you want to snap into place. The browser then chooses the nearest valid snap position after scrolling ends.
> **Difficulty:** Beginner
>
> **You'll understand this better if you know:** basic CSS selectors, how overflow scrolling works, and the difference between a container and its child elements.
## 1. What Is CSS Scroll Snap?
CSS Scroll Snap is a set of CSS properties that tells the browser how to align content when a scroll action ends. Instead of stopping at an arbitrary position, the scroll container can "snap" to a defined child element or alignment point.
- It works on scrollable containers, not on the page by itself unless the page is the scrolling container.
- It helps create predictable, polished scrolling behavior without JavaScript.
- It supports horizontal, vertical, and two-dimensional scrolling layouts.
- It does not force scrolling to happen; it only influences where scrolling settles.
Think of it as a CSS way to say, "when the user scrolls, land here."
## 2. Why CSS Scroll Snap Matters
Scroll Snap improves usability in interfaces where content is meant to be consumed one panel, card, or section at a time. It makes scrolling feel deliberate and tidy, especially on touch devices where users often flick through content quickly.
It matters because it can improve readability, navigation, and visual polish without custom scripting. It also reduces the amount of code needed for common UI patterns like image carousels or onboarding screens.
Use it when the layout has natural stopping points. Avoid it when users need freeform scrolling through long text or dense, irregular content.
## 3. Basic Syntax
CSS Scroll Snap uses two main ideas: the scroll container declares snapping behavior, and the children declare where they want to snap.
### Step 1: Mark the scrolling container
The container needs overflow scrolling and a snap type. The `scroll-snap-type` property tells the browser which axis to snap on and how strictly to snap.
```css
.carousel {
display: flex;
overflow-x: auto;
scroll-snap-type: x mandatory;
}
```
This example creates a horizontally scrollable container that snaps along the x-axis.
### Step 2: Mark the snap targets
Each child that should align cleanly uses `scroll-snap-align`.
```css
.card {
scroll-snap-align: start;
}
```
With `start`, the browser tries to align the start edge of the card with the start edge of the container.
### Step 3: Understand the most common values
The key value pairs you will see most often are:
- `scroll-snap-type: x mandatory` — snap horizontally and strongly enforce snapping.
- `scroll-snap-type: y proximity` — snap vertically only when the scroll ends near a snap point.
- `scroll-snap-align: start` — align the start edge of the item.
- `scroll-snap-align: center` — center the item in the container.
- `scroll-snap-align: end` — align the end edge of the item.
## 4. Step-by-Step Examples
### Example 1: Horizontal card carousel
This pattern is common for product cards, testimonials, or image thumbnails. The container scrolls sideways and each card snaps into place.
```css
.carousel {
display: flex;
gap: 1rem;
overflow-x: auto;
scroll-snap-type: x mandatory;
padding: 1rem;
}
.card {
flex: 0 0 80%;
scroll-snap-align: start;
border: 1px solid #ccc;
border-radius: 0.75rem;
padding: 1rem;
}
```
The cards keep a consistent width, and scrolling naturally lands on the start of each one.
### Example 2: Full-screen section snapping
Scroll Snap can create page-like sections that each fill the viewport. This is useful for presentations, onboarding, or visual storytelling pages.
```css
main {
height: 100vh;
overflow-y: auto;
scroll-snap-type: y mandatory;
}
section {
min-height: 100vh;
scroll-snap-align: start;
}
```
Each section becomes a snap target, so the view stops neatly on section boundaries.
### Example 3: Centered gallery items
Sometimes center alignment looks better than start alignment, especially for cards or previews that should be visually balanced.
```css
.gallery {
display: grid;
grid-auto-flow: column;
grid-auto-columns: 70%;
overflow-x: auto;
scroll-snap-type: x proximity;
}
.gallery-item {
scroll-snap-align: center;
}
```
Using `center` makes the active item feel like the focal point of the viewport.
### Example 4: Mixed content with padding and offsets
In real layouts, headers, padding, or sticky UI can affect how snapping feels. You can add `scroll-padding` to reserve space inside the container and `scroll-margin` to adjust an individual target.
```css
.page {
height: 100vh;
overflow-y: auto;
scroll-snap-type: y proximity;
scroll-padding-top: 4rem;
}
.page-section {
scroll-snap-align: start;
scroll-margin-top: 4rem;
}
```
This keeps snapped content from hiding under a fixed header or other top UI.
## 5. Practical Use Cases
- Horizontal product carousels where each card should rest cleanly in view.
- Image galleries where users swipe through one preview at a time.
- Onboarding or feature tours with full-height panels.
- News or article teasers arranged as scrollable cards.
- Mobile-first interfaces that benefit from touch-friendly snapping.
- Section-based landing pages with clear visual stops.
Scroll Snap works best when each panel is meaningful on its own and users benefit from landing on a stable position after scrolling.
## 6. Common Mistakes
### Mistake 1: Forgetting to make the container scrollable
Scroll Snap only works on an element that actually scrolls. If the container never overflows, there is nothing for the browser to snap.
**Problem:** The container has snap properties, but without overflow the browser never enters a scrollable state.
```css
.carousel {
scroll-snap-type: x mandatory;
}
```
**Fix:** Add horizontal or vertical overflow and give the content a size that can exceed the container.
```css
.carousel {
display: flex;
overflow-x: auto;
scroll-snap-type: x mandatory;
}
```
The corrected version works because the browser can now scroll the container and apply snapping.
### Mistake 2: Applying snap alignment to the wrong element
Snap alignment belongs on the items that should land in place, not on arbitrary wrapper elements that never become visible snap targets.
**Problem:** The snap target is placed on an inner wrapper instead of the visible item, so the snapping feels inconsistent or does nothing useful.
```css
.card {
display: flex;
}
.card-content {
scroll-snap-align: start;
}
```
**Fix:** Put the snap alignment on the actual scroll item that the user expects to land on.
```css
.card {
scroll-snap-align: start;
}
.card-content {
display: flex;
}
```
The corrected version works because the snapping target matches the element users visually interact with.
### Mistake 3: Using mandatory snapping for content that needs free scrolling
`mandatory` snapping can feel restrictive if the content is long, dense, or meant to be read continuously. In those layouts, users may fight the scroll behavior.
**Problem:** Strong snapping forces the browser to stop at every snap point, which can make reading awkward and reduce control.
```css
.article-list {
overflow-y: auto;
scroll-snap-type: y mandatory;
}
```
**Fix:** Use `proximity` when you want snapping to assist the user without taking over the entire scroll experience.
```css
.article-list {
overflow-y: auto;
scroll-snap-type: y proximity;
}
```
The corrected version works because snapping is now softer and easier to use for content that users may want to scan freely.
## 7. Best Practices
### Practice 1: Choose the right snap strength
`mandatory` is best when every stop matters, while `proximity` is better when snapping should feel helpful rather than strict.
```css
.stories {
scroll-snap-type: x proximity;
}
.slides {
scroll-snap-type: y mandatory;
}
```
This distinction helps you match the snap behavior to the content’s purpose.
### Practice 2: Use spacing and padding deliberately
Spacing affects how snap positions feel. Add container padding or item margins when you want the snapped element to breathe instead of touching the edges.
```css
.carousel {
padding-inline: 1rem;
scroll-padding-inline: 1rem;
}
.card {
scroll-snap-align: start;
}
```
This creates a more polished layout and prevents content from feeling cramped.
### Practice 3: Keep snap targets predictable in size
Snap works best when children have stable sizes or clear bounds. Very irregular heights can make snapping feel jumpy or hard to anticipate.
```css
.panel {
min-height: 80vh;
scroll-snap-align: start;
}
```
Stable sizes make snapping feel intentional and easier for users to follow.
## 8. Limitations and Edge Cases
- Scroll Snap does not create scrolling by itself; the container still needs `overflow`.
- Very tall or very short items can make snap behavior feel uneven if their size differs too much from the viewport.
- Nested scroll containers can make it hard to tell which element should snap.
- Some users may prefer reduced motion or simpler scrolling experiences, so design with restraint.
- Snapping can feel awkward if content is meant to be read linearly, such as long articles or form pages.
- Browser behavior can vary slightly in how aggressively it chooses the nearest snap point, especially with touch and inertial scrolling.
When a layout feels like it is "not snapping," the most common causes are missing overflow, the wrong axis, or snap targets that are not actually reachable.
## 9. Practical Mini Project
Here is a small working example for a horizontal feature strip. It uses only CSS Scroll Snap and standard HTML structure.
```html
Fast setup
Clean design
Mobile friendly
.feature-strip {
display: flex;
gap: 1rem;
overflow-x: auto;
scroll-snap-type: x mandatory;
padding: 1rem;
}
.feature-card {
flex: 0 0 75%;
min-height: 10rem;
scroll-snap-align: start;
border: 1px solid #d0d0d0;
border-radius: 1rem;
display: grid;
place-items: center;
}
```
This mini project demonstrates the full pattern: a scrollable container, snap-aligned items, and a layout that feels natural on touch and trackpad scrolling.
## 10. Key Points
- CSS Scroll Snap controls where scrolling settles after user input.
- `scroll-snap-type` belongs on the scroll container.
- `scroll-snap-align` belongs on the items that should snap.
- `mandatory` is strict; `proximity` is softer.
- `scroll-padding` and `scroll-margin` help fine-tune alignment.
- It is ideal for carousels, galleries, and section-based layouts.
## 11. Practice Exercise
- Create a vertical scroll container with four sections.
- Make each section at least 80% of the viewport height.
- Snap the sections to the top edge of the container.
- Add padding so the content does not touch the edges.
**Expected output:** When you scroll the container, each section should settle neatly into place instead of stopping halfway through.
**Hint:** Apply `overflow-y: auto` and `scroll-snap-type: y mandatory` to the container, then use `scroll-snap-align: start` on each section.
```html
.snap-demo {
height: 100vh;
overflow-y: auto;
scroll-snap-type: y mandatory;
padding: 1rem;
}
.snap-panel {
min-height: 80vh;
scroll-snap-align: start;
margin-block: 1rem;
border: 1px solid #ccc;
}
```
This solution works because the container scrolls, the sections are large enough to snap meaningfully, and each section declares a clear alignment point.
## 12. Final Summary
CSS Scroll Snap gives you a simple, declarative way to control where scrolling ends. With just a few properties, you can create polished carousels, section-based layouts, and touch-friendly interfaces that feel much more intentional than free-scrolling content.
The main idea is straightforward: make a container scrollable, choose a snap axis, and mark the child elements that should align. From there, you can fine-tune the experience with alignment values, padding, and margins so the snapping feels natural rather than rigid.
If you want to go further, next learn about `overflow`, `position: sticky`, and responsive layout techniques so you can combine Scroll Snap with real-world interfaces more confidently.
## Browser Support
| Feature | Status | Chrome | Edge | Firefox | Safari | Safari iOS |
| --- | --- | --- | --- | --- | --- | --- |
| Scroll snap | Widely available since Jul 2022 | 69+ | 79+ | 68+ | 11+ | 11+ |
Data: web-features 3.43.0 (MDN Baseline).