Skip to Content

Enable Smooth Scrolling with JavaScript

A third-party library used to be required to accomplish simple effects like a smooth scrolling with JavaScript. Those days are history now that JavaScript supports this feature across almost all modern browsers with the built-in window.scrollTo() method.

Ad - Web Hosting from SiteGround - Crafted for easy site management. Click to learn more.
Advertising Disclosure: I am compensated for purchases made through affiliate links. Click here for details.

Why Use Smooth Scrolling?

Put yourself in the user's position. You click on a web page element, only to find that the screen has suddenly changed and you don't know what happened or where you are. This abrupt change can be confusing to many users.

Enter smooth scrolling, which JavaScript provides seamlessly. Think of it as a guide. The animation guides you to the desired spot after clicking on a web page element. So now you know where you are and how you arrived there. Overall, it provides a more pleasant and user-friendly experience.

While smooth scrolling is a great feature to have, it can also be easily abused. Make sure that you're not putting auto-scroll features all over your site where your users wouldn't expect to have it. Clicking a menu option or button to take a user to a different part of the current page is ideal, but setting auto-scrolls throughout the site to lure them to other places they wouldn't expect is not.

How to Animate Scrolling with JavaScript

You're probably already familiar with creating a scroll that automatically jumps to a specific location within a webpage:

window.scrollTo(0, 1000);

The above snippet jumps the user down 1,000 pixels vertically from the top of the web page, just without the animation.

Create a smooth scrolling animation with the following JavaScript syntax:

top: 1000,
behavior: "smooth"

The second snippet provides the same result as the first, except this time it animates down 1,000 pixels vertically from the top of the web page.

Incremental Scroll

There may be times where you don't want to scroll to a specific Y position on a web page, but you want to scroll up or down an exact pixel amount.

This is known as incremental scrolling, which you can accomplish this with JavaScript's window.scrollBy() method:

top: -100,
behavior: "smooth"

Scroll to the Top of the Page

You can scroll to the top of the page by setting the "top" attribute to 0, the first Y position in an HTML page:

top: 0,
behavior: "smooth"

Scroll to the Bottom of the Page

Similarly, you can scroll to the bottom of the page by retrieving the window's inner height:

top: window.innerHeight,
behavior: "smooth"

Scroll to a DOM Element

This option creates an automatic smooth scrolling animation to an element within the DOM:

.scrollIntoView({behavior: "smooth"});

This piece of code looks for the DOM element with ID orangeable, then scrolls to the top portion of that element until it's in view.

Scrolling Behaviors

There are only two available behavior methods for smooth scrolling with JavaScript:

  • smooth: The scrolling animates smoothly.
  • auto: The scrolling happens in a single jump.

If you want to jump scroll, you can save yourself the extra code and use the window.scrollTo() method with X and Y values that we discussed earlier.

Browser Support

Smooth scrolling is available for use in most modern browsers. Unfortunately for Apple users, Safari does not support his feature yet, however, there is a polyfill option available that will fill the gap and provide the functionality you're looking for.


Give smooth scrolling a shot in your next project! It's great fun to work with, extremely easy to implement, and provides a better overall experience for your users.

Posted by: Josh Rowe
Last Updated: September 22, 2022
Created: April 20, 2021


There are no comments yet. Start the conversation!

Add A Comment

Comment Etiquette: Wrap code in a <code> and </code>. Please keep comments on-topic, do not post spam, keep the conversation constructive, and be nice to each other.