Title: Gredich Smooth Scroll
Author: Gredich
Published: <strong>July 15, 2026</strong>
Last modified: July 15, 2026

---

Search plugins

![](https://ps.w.org/gredich-smooth-scroll/assets/icon-256x256.png?rev=3609283)

# Gredich Smooth Scroll

 By [Gredich](https://profiles.wordpress.org/gredich/)

[Download](https://downloads.wordpress.org/plugin/gredich-smooth-scroll.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/gredich-smooth-scroll/#description)
 * [Reviews](https://wordpress.org/plugins/gredich-smooth-scroll/#reviews)
 *  [Installation](https://wordpress.org/plugins/gredich-smooth-scroll/#installation)
 * [Development](https://wordpress.org/plugins/gredich-smooth-scroll/#developers)

 [Support](https://wordpress.org/support/plugin/gredich-smooth-scroll/)

## Description

Adds Lenis library for smooth scrolling with a full settings page — no coding required.
Unlike headless wrappers, it includes:

Features:
 * GSAP/ScrollTrigger integration * Smooth anchor links with configurable
offset * Automatic nested scroll detection * Exclude specific elements by ID or 
class * Support for both vertical and horizontal scrolling * Touch device support
with adjustable sensitivity * Easy-to-use settings page

### Development

Build assets (JS, CSS) are copied from the `lenis` npm package.
 Source code and
full development repository available at: – Lenis library: https://github.com/darkroomengineering/
lenis

## Installation

 1. Upload the `gredich-smooth-scroll` folder to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Go to Settings > Gredich Smooth Scroll to configure the plugin

## FAQ

### How do I exclude an element from smooth scrolling?

There are two ways:

 1. **Using data attributes (recommended):** Add `data-lenis-prevent` attribute to 
    any HTML element you want to exclude. For finer control, use:

 Attribute
 Description

 `data-lenis-prevent`
 Prevent all smooth scroll events

 `data-lenis-prevent-wheel`
 Prevent wheel events only

 `data-lenis-prevent-touch`
 Prevent touch events only

 `data-lenis-prevent-vertical`
 Prevent vertical scroll events only

 `data-lenis-prevent-horizontal`
 Prevent horizontal scroll events only

 1. **Using the settings page:** Go to Settings > Gredich Smooth Scroll and add the
    element’s ID or class to the exclusion list.

### What is the difference between ID and class selectors?

 * ID selectors start with `#` (e.g., `#my-element`)
 * Class selectors start with `.` (e.g., `.my-class`)

### Can I use both methods together?

Yes! You can combine data attributes with ID/class exclusions.

### How does the plugin handle nested scroll elements?

By default, the plugin automatically detects nested scrollable elements and lets
them scroll natively. You can control this behavior from **Settings > Gredich Smooth
Scroll** using the “Allow Nested Scroll” option.

 * **Enabled (default):** Lenis detects nested scroll containers automatically. 
   Best for most sites.
 * **Disabled:** Disable only if you experience performance issues and prefer to
   manually exclude elements using the data attributes or exclusion list above.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Gredich Smooth Scroll” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Gredich ](https://profiles.wordpress.org/gredich/)
 *   [ Diego ](https://profiles.wordpress.org/diarpu/)

[Translate “Gredich Smooth Scroll” into your language.](https://translate.wordpress.org/projects/wp-plugins/gredich-smooth-scroll)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/gredich-smooth-scroll/),
check out the [SVN repository](https://plugins.svn.wordpress.org/gredich-smooth-scroll/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/gredich-smooth-scroll/)
by [RSS](https://plugins.trac.wordpress.org/log/gredich-smooth-scroll/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * Initial release

## Meta

 *  Version **1.0.0**
 *  Last updated **6 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **7.0.1**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [lenis](https://wordpress.org/plugins/tags/lenis/)[scroll](https://wordpress.org/plugins/tags/scroll/)
   [scrolling](https://wordpress.org/plugins/tags/scrolling/)[smooth](https://wordpress.org/plugins/tags/smooth/)
   [smooth scroll](https://wordpress.org/plugins/tags/smooth-scroll/)
 *  [Advanced View](https://wordpress.org/plugins/gredich-smooth-scroll/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/gredich-smooth-scroll/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/gredich-smooth-scroll/reviews/)

## Contributors

 *   [ Gredich ](https://profiles.wordpress.org/gredich/)
 *   [ Diego ](https://profiles.wordpress.org/diarpu/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/gredich-smooth-scroll/)