This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.



I really like InuYaksa’s Nicescroll JS plugin. I’m a fan. And I thought there may be others like me who would enjoy using his famous library with a simple interface. So I came up with this plugin. It is a wrapper for the popular “Nicescroll” javascript library, which is developed and maintained by InuYaksa. You can visit his official Nicescroll homepage here. An overview of the default parameters can be found on Github at the bottom of the page. This plugin enables you to use the Nicescroll scrollbar on both the frontend and the backend. It is fully customizable, you can tweak and tune every single parameter Nicescroll has to offer! You can style it totally different for both views. You can even keep the default scrollbar with Nicescroll’s smooth scroll behaviour if you like. It’s all up to you. Install and enjoy 🙂


  • Nicescroll jQuery library
  • Fully customizable
  • Frontend and backend
  • Back to top buttons


  • PHP 5.3+


  • Basic settings panel.
  • Extended settings panel, upper part.
  • Extended settings panel, lower part.


  1. Upload the nicescrollr folder to your /wp-content/plugins/ directory.
  2. Activate the “Nicescrollr” plugin through the “Plugins” menu in WordPress.
  3. You will find its settings page listed in the “settings” section.
  4. Go to the plugin settings page and fit it to your needs 🙂 Have fun!


Installation Instructions
  1. Upload the nicescrollr folder to your /wp-content/plugins/ directory.
  2. Activate the “Nicescrollr” plugin through the “Plugins” menu in WordPress.
  3. You will find its settings page listed in the “settings” section.
  4. Go to the plugin settings page and fit it to your needs 🙂 Have fun!
Why doesn’t it work with my theme?

Most likely, this is because your theme (or another plugin?) already has the Nicescroll library on board. If that’s the case, I advise you to uninstall this plugin again to prevent compatibility issues. Of course, you can always ask your theme developer to implement a function to disable the built-in solution if you like to use this plugin and its options.

The capability required for being able to customize settings is the following:

  • nicescrollr_edit – The user can change settings regarding this plugin.
Can you help me?

Well, I provide some basic support on this plugin’s support page. I check that place once or twice a month, so you may have to be a bit patient.


Does what it suggests except …

Does what it suggests except when there are accordions on the page. When opening accordions the whole length of a site becomes longer and nicescrollr doesn’t consider that. The site stops scrolling at the initial length, not the complete length.

Il migliore scrollbar | The best who work scrollbar plugin

I tried different plugins with theme Customizr, no one works, this one is working very well and is full customable.

Il miglior plugin per personalizzare la barra laterale di navigazione del browser.

Not working anymore since 21/08/2017
the update create many different issue on my websites.

The scroll was not working well and cut my website footer. New plugin has also updated database and after removed was not able to resume a previous version as you cannot download it.

Also if you edit some settings you are lost… database will be changed and … so a small bug or big bug create very big issues.

Broke website with update is something very dangerous for websites.

24/08/2017 : all problem solved.

You can update now if you like.

The plugin will keep your settings and it will respond to document changes such as height, which means that your visitors will be able to scroll trough the entire document even if the height changes. That’s pretty cool.

Don’t forget to backup your database, as you should always do before installing new / updating existing software.



05/09/2017 plugin does not work again…. maybe is z index set to auto maybe is bug that show auto hide is always on also when you disabled… something is not working well.

Settings are lost after some while. All customization are lost.
Seems plugin auto reset sometimes.

18 september 2017 testing last update 0.56

26/09/2017 : no plugin is perfect and has no issue, all issue or almost has been fixed and this is amazing plugin so 5 stars again!

Muito Bom o Plug IN

Top demais o Plug-in. Me ajudou muito, o único que o scroll vai do funto até em cima.

Very nice Plug-in, the best of this type. Very good job of the developer.

Read all 6 reviews

Contributors & Developers

“Nicescrollr” is open source software. The following people have contributed to this plugin.

Translate “Nicescrollr” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.


Version 0.5.7

  1. Changed default z-index value to 99998 (covers all elements “below” the admin bar)
  2. Changed default auto-hide mode for frontend and backend to ‘disabled’
  3. Optimized the listener that watches changes on the document

Version 0.5.6

  1. Added some styling options for the backtop buttons. I advise you to navigate to the settings pages for the frontend and the backend and simply hit the “save settings” button to add the new features

  2. Removed the deprecated plugin settings tab

  3. Renamed the class name for the backtop button
  4. Fixed a bug regarding the scroll-to functionality, which is used to scroll to settings that did not pass validation
  5. Added credit to the author of Nicescroll in the description text
  6. Several code improvements
  7. Updated the note regarding my support forum visits
  8. Moved the reset buttons to the respective settings tabs

Version 0.5.5

  1. The plugin can handle document changes now (adopts to changes in height)

Version 0.5.4

  1. Fixed an error that occurred during plugin activation

Version 0.5.3

  1. Updated the Nicescroll library to the latest version (3.7.6), now loads from CDN with local fallback
  2. Updated jQuery Easing library to the latest version (1.4.1), now loads from CDN with local fallback
  3. Updated the settings and the default values to fit the current Nicescroll version
  4. Updated readme files and the help tab
  5. Back-top button is now available for the entire backend
  6. Added the optional back-top button for the entire frontend
  7. Minor stability and performance improvements
  8. Minor UI changes

Version 0.5.2

  1. Fixed a bug regarding the case of an empty options array
  2. Minor code optimisations
  3. Removed a plugin setting – ScrollTo is enabled by default now
  4. Minor UI changes
  5. Disabled Nicescroll options that are not related to this plugins’s functionality (boxzoom, iframeautozesize, …)
  6. Removed local fallback for Font Awesome

Version 0.5.0

  1. Upgraded Nicescroll to version 3.6.8. Scroll behaviour may has changed since the library changed. Tweak the settings mentioned under 4. in this list if necessary
  2. Added easing
  3. Upgraded Alertify
  4. Replaced IcoMoon icons in favour of Font Awesome 4.7.0 ( loads via CDN with local fallback )
  5. Moved “Scroll Speed” and “Mouse Scroll Step” to the basic settings section for easier access
  6. Refactored and optimized scripts and code
  7. Updated the default settings
  8. Resolved an issue with “scroll top”

Version 0.4.0

  1. Minor bug fixes
  2. Minor code optimisations

Version 0.3.0

  1. Updated the user interface, all options are available again
  2. Refactored the javascripts
  3. Support for PHP Version 5.3 ( was 5.4+ )
  4. Removed “Fugaz One” font family
  5. Minor code optimizations

Version 0.2.2

  1. Nicescroll is now being disabled on mobile devices with a screen width below 960px to enhance user experience and prevent touch-related incompatibilities.


  1. Fixed missing stuff…
  2. Fixed compatibility with “cbParallax”, which uses the Nicescroll library

Version 0.2.1

  1. Added an option to replace the nicescroll scrollbar with the browsers default scrollbar
  2. Some minor code and comment cleanup

Version 0.2.0

  1. Resolved the translation bugs
  2. Optimized the default settings for both the frontend and the backend
  3. Implemented the
    It basically widens the rail and the cursor if their width is below 16px to 16px on hover so it’s easier to grab it
  4. Modified the interface
  5. Updated the screenshots

Version 0.1.1

  1. Fixed the icons.
  2. Replaced the switch for the checkbox with one that’s compatible with Safari browsers.
  3. Added the option to assign a background color to the rail on both frontend and backend.
  4. Slightly modified the content of the help settings_tab.
  5. Updated the German translation.
  6. Fixed an issue with a missing url for “scrollTo”.
  7. Made the validation error notices dismissable.
  8. The scrollTo-extension now also works for the color pickers.
  9. Some minor bug fixes.

Version 0.1.0

First commit.