Overview
Smush describes itself as: “Compress and optimize images, enable lazy load, serve WebP & AVIF, and speed up your site with a global image CDN.”
It is active on 1+ million WordPress sites and rated 4.8 out of 5 by 6,053 users on WordPress.org. Developers can extend it through 52 actions and 145 filters, listed below.
How to install Smush
- Open the plugin installer. In your WordPress dashboard go to Plugins → Add New Plugin.
- Search for it. Type “Smush” and pick the one by WPMU DEV - Your All-in-One WordPress Platform.
- Install and activate. Click Install Now, then Activate.
Install with a zip file or WP-CLI
Download the zip from the WordPress.org plugin page, then go to Plugins → Add New Plugin → Upload Plugin, choose the file and click Install Now. Or from the command line:
wp plugin install wp-smushit --activateRequirements: WordPress 6.4+ · PHP 7.4+ · tested up to WordPress 7.1.4
Hooks & customisation
Smush 4.3.7 fires 52 actions and 145 filters. Use them from your child theme or a snippets plugin to change how it behaves without editing its files.
// Cache and returns the result. Also added a hook for third-party.
apply_filters( 'wp_smush_is_smushable', … );
// Allows to skip a image from smushing
apply_filters( 'wp_smush_media_image', true, $image_size, $retina_file, $id );
// Filter to modify auth error text.
apply_filters( 'wpmudev_hub_connector_get_auth_error', $error, self::$plugin_identifier );
// Allows to Enable/Disable WP Retina 2x Integration
apply_filters( 'smush_retina_images', true );
// Filter to skip a single image from lazy load.
apply_filters( 'smush_skip_image_from_lazy_load', false, $src_url, $markup );
// Filters the Document root path used to get relative paths for webp rules. Hope…
apply_filters( 'smush_webp_rules_root_path_base', $root_path );Need Smush customised?
Tell us what you want changed, added or fixed and we'll reply with an estimate.
WP EXPERTS is independent and not affiliated with WPMU DEV - Your All-in-One WordPress Platform. Plugin names and logos belong to their owners. Version, rating and install figures from WordPress.org, checked Nov 17, 2026.