Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

WP SmartCrop

Style your images exactly how you want them to appear, for any screen size, and never get a cut-off face. WP SmartCrop will crop your images, on-the-fly, keeping the main focal point in view.


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.

  • 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.

Getting Started

  1. Install and activate the WP SmartCrop plugin
  2. Upload images to your Media Library
  3. Select an image in the library, so that image details appear on the right
  4. Check the Enable Smart Cropping checkbox.
  5. Find the preview thumbnail of the image (at the top of the sidebar from the 'insert media' screen, or to the left on the media library details screen)
  6. Click the focal point of the image. 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.
  7. Insert the image into a page or post
  8. Style your image, using the img.wpsmartcrop-image selector

##Compatibility WP SmartCrop has been fully tested in the following browsers:

  • Safari
  • Chrome
  • Firefox
  • Opera
  • Microsoft Edge
  • Internet Explorer 9-11
  • IOS 7+
  • Android 4.0+
  • Windows Phone 8.1

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.

Frequently Asked Questions

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

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 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 WP SmartCrop 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, or leave us a review/rating.


No description, website, or topics provided.




No releases published


No packages published