Title: Smooth Custom Cursor
Author: hsarticle
Published: <strong>May 17, 2026</strong>
Last modified: May 17, 2026

---

Search plugins

![](https://ps.w.org/smooth-custom-cursor/assets/banner-772x250.png?rev=3534244)

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.

![](https://ps.w.org/smooth-custom-cursor/assets/icon-256x256.png?rev=3534244)

# Smooth Custom Cursor

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

[Download](https://downloads.wordpress.org/plugin/smooth-custom-cursor.2.1.zip)

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

 [Support](https://wordpress.org/support/plugin/smooth-custom-cursor/)

## Description

**Smooth Custom Cursor** replaces the default browser cursor with a beautiful animated
dot + ring cursor effect. Fully customizable from the WordPress admin panel.

**Features:**

 * Smooth lagging ring animation using requestAnimationFrame
 * Magnetic scale effect on hover over links and buttons
 * Customizable cursor color (color picker)
 * Customizable cursor size
 * Option to disable on mobile/touch devices
 * Hides cursor when mouse leaves the browser window
 * Zero dependencies — pure vanilla JavaScript
 * Lightweight and performance-optimized

## Installation

 1. Upload the `smooth-custom-cursor` folder to the `/wp-content/plugins/` directory,
    or install directly via **Plugins  Add New** in WordPress admin.
 2. Activate the plugin through the **Plugins** menu.
 3. Go to **Settings  Cursor Ultimate** to configure the cursor color, size, and mobile
    behavior.

## FAQ

### Does it work with all themes?

Yes. The plugin injects the cursor elements via `wp_footer` and loads styles/scripts
on all frontend pages.

### Can I disable it on mobile?

Yes. In **Settings  Cursor Ultimate**, check the “Disable on Mobile” option.

### Why does my default cursor still show?

Make sure no other plugin or theme CSS is overriding `cursor: none`. The plugin 
sets `cursor: none !important` on all elements.

### What WordPress version is required?

WordPress 5.8 or higher.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

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

Contributors

 *   [ hsarticle ](https://profiles.wordpress.org/hsarticle/)
 *   [ himanshu ](https://profiles.wordpress.org/himanshu/)

[Translate “Smooth Custom Cursor” into your language.](https://translate.wordpress.org/projects/wp-plugins/smooth-custom-cursor)

### Interested in development?

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

## Changelog

#### 2.1

 * Fixed: Correct asset paths for CSS and JS files
 * Fixed: Admin settings include path corrected
 * Fixed: JS variable name aligned with wp_localize_script output
 * Fixed: Cursor HTML elements now injected via wp_footer hook
 * Fixed: CSS variables now output via wp_head hook
 * Fixed: disableMobile option now correctly passed to JavaScript
 * Security: Added nonce verification to settings form (CSRF protection)
 * Security: Added capability check in settings page function
 * Improved: Cursor hides when mouse leaves the browser window
 * Improved: Input validation with min/max for size field

#### 2.0

 * Initial release.

## Meta

 *  Version **2.1**
 *  Last updated **11 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **6.5.8**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [animation](https://wordpress.org/plugins/tags/animation/)[cursor](https://wordpress.org/plugins/tags/cursor/)
   [custom cursor](https://wordpress.org/plugins/tags/custom-cursor/)[mouse](https://wordpress.org/plugins/tags/mouse/)
 *  [Advanced View](https://wordpress.org/plugins/smooth-custom-cursor/advanced/)

## Ratings

No reviews have been submitted yet.

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

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

## Contributors

 *   [ hsarticle ](https://profiles.wordpress.org/hsarticle/)
 *   [ himanshu ](https://profiles.wordpress.org/himanshu/)

## Support

Got something to say? Need help?

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