Meet smart crop by Uploadcare

Resizing a batch of images for a website isn't as simple as you might think. Are there any alternatives to spending hours manually tweaking each image that doesn’t involve the risk of headless photos? Yep. Smart Crop by Uploadcare.

What is smart crop?

Smart Crop is a built-in image processing operation in Uploadcare. It leverages AI and deep learning neural networks to automatically crop your image so that only important things, such as faces, silhouettes and objects, remain visible. The rest of the image, which contains background or insignificant details, is removed.

What's the idea? The feature is intended to make daily tasks easier for people who have large catalogs and a lot of product photos in different resolutions and orientations. For example, you can:

Automatically create nice-looking image thumbnails:

Apply smart crop online to create thumbnailsApply smart crop online to create thumbnails

Adapt your images to a new website design:

Resize images online to match updated website designResize images online to match updated website design

Automatically adjust the size of the images your users upload, for example, for their profile photos:

Online image crop for avatars and profile photosOnline image crop for avatars and profile photos

But first: prerequisites

Before we get too far, here's a quick reminder of how image transformations work in Uploadcare:

First of all, you need to sign up for an Uploadcare account. After that, you’ll be able to create your first project from the dashboard and start uploading your images.

Once an image is uploaded, you receive a CDN link with its unique identifier (UUID). From there, you can crop, align, resize, and enhance your images by simply adding different URL parameters. For example:

Read the guide Quick Image Manipulations Using Only URL on our blog to find more information; and, of course, there’s a page in the Docs.

Now that you’re all set, how about we smart crop a picture together?

How to adjust images online with smart crop?

Here’s our test image. It’s large and horizontal, and we need to tweak it to fit our webpage.

A sample image for an online smart crop operationOriginal image dimensions are 7691x5130px

To apply Smart Crop, we need to simply specify the necessary dimensions with the smart crop command. Uploadcare image processing will scale and crop your image automatically and output it with the desired dimensions.

The general URL scheme looks like this:\_crop/:two\_dimensions/smart/


  • :uuid is a unique file identifier assigned to every uploaded file.
  • /-/ is a mandatory delimiter that separates operations from one another and other path components.
  • :scale_crop is a CDN operation URL directive.
  • :smart, when added, enables the smart mode.

For instance, let's say we need to get a 300x300 px image. To apply the smart crop feature, your URL should look like this:

Let’s put in a real UUID to set what we get:

A sample image with a woman on the beach before a crop operationA sample image with a woman on the beach before a crop operation

The Smart Crop algorithm detected a person in the center and cropped the background

Just in case you consider cropping an image with a person in the very center an easy task, let’s do the same exercise once again with another image:

A sample portrait for an online smart crop operationA sample portrait for an online smart crop operation

The face is considered to be the most important part of an image, so it’s preserved.

How does smart crop decide what’s important?

Smart Crop has an AI algorithm in its core that detects objects in images. The algorithm uses three methods of image analysis:

  • Face detection (locates human faces)
  • Object detection (locates the most visually important areas of an image)
  • Corner points detection (analyses image pixels to find the high contrast corners in the image. Useful for abstract, landscape, and art images)

Uploadcare uses all this information to work with images, but every so often, there's more than one object in a picture. Have a look at the image below. There are two objects: a person and a camera. Which one will Smart Crop leave and which will it crop? What’s more important?

A sample image for smart crop with two important objectsA sample image for smart crop with two important objects

To deal with this issue, the Smart Crop feature has a built-in prioritization mechanic. That means you can set what type of object is most important for you. By default, :type is set to smart and the priority sequence is: faces → objects → corner points.

Let’s see how it works in practice and crop our sample image to 700x300 px:


A sample image with two important objects after applying smart cropA sample image with two important objects after applying smart crop

However, we might want to use this image as a camera ad; in that case, we need the camera and can crop the person if he doesn’t fit in the frame. Then we can prioritize the objects:


A sample image with two important objects after applying smart crop with priority on objectsA sample image with two important objects after applying smart crop with priority on objects

Here's another example. Say we want to create thumbnails for a sports clothing store, and it’s important for us to demonstrate a brand or a logo on an item. Then let’s give priority to the Corner Points detection:


A sample image with several important objects after applying smart crop with priority on corner pointsA sample image with several important objects after applying smart crop with priority on corner points

Are there any limitations for smart crop?

Although Smart Crop is efficient in most cases, it can deliver mixed results when there are multiple objects in a picture. The algorithm strives to capture all the objects, so sometimes it can preserve secondary objects and regions you don’t need.

In that case, as well as if you don’t have a CDN project yet, you can opt for the manual cropping feature.

The bottom line

At Uploadcare, we believe that not a minute should be spent on performing a task that can be easily automated; and no resources should be invested in long in-house DIY development if an out-of-the-box solution exists.

Smart Crop is a part of the Image Intelligence engine built into the Uploadcare file-handling infrastructure. With its help, you can dramatically decrease your IT department workload, cut costs for developing in-house file handling solutions, and save a bunch of time. If you’d like to know more about the image transformations Uploadcare can perform, also visit our docs; and of course, we encourage you to explore the feature in practice and tell us what you think about it in the comments below!

Build file handling in minutesStart for free

Ready to get started?

Join developers who use Uploadcare to build file handling quickly and reliably.

Sign up for free