WP SmartCrop


WP SmartCrop allows you to set the ‘focal point’ of any image, right from the media library, then crops your images to match your css rules (no more squished aspect ratios), keeping that focal point, not only in view, but as near as possible to a ‘rule of thirds’ position in the image. The results are powerful, composed photos at any screen size, with any constraints.

Learn More at: https://www.wpsmartcrop.com/

  • Visually select your images’ focal points with an intuitive click-based interface
  • Quickly enable or disable smart-cropping on a per-image basis.
  • Easily target only the images you want to style, with the img.wpsmartcrop-image selector
  • Automatic image preloader, so your users never see partially loaded images again
  • Semantic HTML5/CSS3 for modern browsers, with automatic fallback to non-semantic HTML4/CSS2 for older browsers.
  • Lightweight and fast processing of images, even inside post content
  • Fully compatible with common caching and optimization plugins and solutions, such as W3 Total Cache, Wordfence, WPEngine’s EverCache, Better WordPress Minify, and Google’s PageSpeed Module.
  • Lets you take full advantage of the new responsive srcset features added in WordPress 4.4, to make the most of your images.
  • NEW! Legacy support for existing cropped thumb sizes allows you to see improvements, right out of the box, without changing your CSS!


WP SmartCrop has been fully tested in the following browsers:

  • Safari
  • Chrome
  • Firefox
  • Microsoft Edge

This is by no means an exhaustive list of supported devices; it just represents our primary target platforms.



Please Rate/Review and Enjoy

Your Ratings and Reviews help us to direct our development, and help other users know what to expect.


  • An example of featured image styling done with WP SmartCrop

  • The additions to the Media Library interface.

  • Setting an image’s focal point.


You can use the built in installer and upgrader, or you can install the plugin

From your WordPress dashboard

  1. Visit ‘Plugins > Add New’
  2. Search for ‘WP SmartCrop’
  3. Activate WP SmartCrop from your Plugins page.

From WordPress.org

  1. Download WP SmartCrop.
  2. Upload the ‘wp-smartcrop’ directory to your ‘/wp-content/plugins/’ directory, using your favorite method (ftp, sftp, scp, etc…)
  3. Activate WP SmartCrop from your Plugins page.

Once Activated

  1. Upload images to your Media Library
  2. Select an image in the library, so that image details appear on the right
  3. Check the Enable Smart Cropping checkbox.
  4. click edit focal point to choose the location of your images focal point
  5. Click the focal point of the image in the modal that appears. This should be the central subject, and the area of the image that we want in view at all times. For a portrait, I recommend clicking an eye, or other powerful feature. You can change the focus at any time, simply by clicking on a new part of the image.
  6. Click apply so save your changes
  7. Insert the image into a page or post
  8. Style your images with CSS, using the img.wpsmartcrop-image selector


Q. I installed the plugin, and nothing changed. What gives?

A. WP SmartCrop is designed to simplify the process for styling your responsive images, but you need to add some styles for it to use. Try adding this snippet to your theme’s style.css file, as a test:

img.wpsmartcrop-image {
    display: block;
    width: 100%;
    height: 200px;

Once you’ve verified that the plugin is working, go wild! Some example css for inspiration can be found at https://www.wpsmartcrop.com/demos

Q. Why can’t you choose the focal points for me?

A. We’re currently working on a “pro” version that will do exactly that. If you’re interested in the feature, let us know as a feature request. It always helps to see people interested in further developments.

Q. Can I integrate WP Smart Crop in my theme?

A. We love to see theme integrations, but reach out to us first, at support@bytes.co. We maintain a separate, paid branch for theme developers that has some necessary changes and integrations incorporated, and there are some caveats that should be followed to make sure your theme is fully compatible with our future roadmap. Otherwise, feel free to list it as a suggested plugin with your theme.

Q. Your plugin is bad, and you should feel bad!

A. That’s not really a question, but at least our moms like us. Feel free to send your ‘constructive criticism’ to support@bytes.co, or leave us a review/rating.


നവംബർ 8, 2022 3 replies
I had to alter the plugin code slightly to allow it to work with custom sizes as well. It would also be nice if the smart crop dimensions weren’t removed upon plugin deactivation, also, if the smart cropping functionality was behind a user role privilege check.
ജൂൺ 14, 2019
The plugins worked quite well, but not in IE 11. There it broke the site. Sadly I got no help with that from the developer. So I stopped using it. Another downside (but probably not solvable by a plugin): the preview of links on facebook and twitter is still the non edited one.
ഫെബ്രുവരി 28, 2019 1 reply
Seems really promising but I didn’t got it working in WP 5.1.0. Neither WP Smart Crop v 2.0 (UI works, but output unchanged) nor 1.5. (UI doesn’t work anymore, can’t select focal point).
Read all 9 reviews

Contributors & Developers

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


Translate “WP SmartCrop” into your language.

Interested in development?

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



  • Fix attribute parsing issue


  • Add support for generic img tags with the default url format


  • Add support for figure markup


  • Test against WordPress 5.6.0
  • Fix a PHP Notice generated by admin settings UI (PR #12, props to @basvandenwijngaard)


  • Fix potential security concern


  • Update admin email


  • Remove mutation observer for IE11


  • Fix admin url


  • Fix custom image size issue


  • completely rework media library interface for ease of use and compatibility
  • add support for relative position mode
  • incorporate mutation observer for live ajax updates
  • fix support for setting focal point in JS


  • fix compatibility with modals in the media library’s grid view


  • fix misplaced parenthesis on count causing warnings on php 7


  • version bump in attempt to fix wordpress.org listing bug


  • Fix for list view


  • center smartcrop focus by default.
  • fix conflict with jQuery 3.0+
  • remove unnecessary IOS compatibility mode


  • fix settings link on plugins page


  • switch to minified js


  • add unnecessary $(window).load event, to solve intermittent issues in Edge Browser


  • abstract wp-smartcrop into a jquery plugin
  • repair list view in media library


  • Fix focal point selection at large resolutions


  • Fix issue with edge cases and focal positions of with 0 as a coordinate


  • Provide better support for iOS devices
  • additional css tweaks for better universality


  • Add initial steps towards add-on friendliness
  • Add extensible settings page


  • Recrop existing cropped thumbnail sizes to match focal point


  • Initial Release