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

May 19, 2026
I started using this plugin as soon as it launched and I’m really liking it so far. The cursor animation feels smooth and clean, and it adds a nice modern touch to my site without being distracting. Setup was quick and everything worked perfectly with my theme right away. Simple plugin, but it does exactly what I needed.
Read all 1 review

Contributors & Developers

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

Contributors

Translate “Smooth Custom Cursor” into your language.

Interested in development?

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

Changelog

2.1

  • Fixed: CSS variables now injected via wp_add_inline_style
  • Fixed: All functions and options prefixed with smoocucu_
  • Fixed: POST inputs now use isset, wp_unslash and sanitization
  • Fixed: ABSPATH check added to all PHP files
  • Security: Nonce verification on settings form
  • Security: Capability check on settings page
  • Improved: Cursor hides when mouse leaves browser window

2.0

  • Initial release.