WordPress error cropping image – The way we fix it

Table of Contents

Can you imagine your WordPress site without images? Images bring out the personality of any content.

Sometimes when you edit an image before uploading, you will see the message

There has been an error cropping your image.

‘WordPress error cropping image’ mainly happens because of the absence of the GD (Graphics Draw) package.

Today lets see what leads to this error and how our Support Engineers fix this for our customers.



How does image cropping error look?

WordPress offer freedom to build websites, hobby blogs, etc. Hence it always includes features to upload images.

Let’s take a look at how the image cropping error look.

To upload an image in WordPress users use the option “Select and Crop”. Then adjust the crop selection, then select “Crop Image”. When things do not work, it shows the message ‘There has been an error cropping your image’. Here, the WordPress “Media Library” turns grey and results in the error.

Image displaying error in text formate 'There has been an error cropping your image'.

The most common reason leading to the error is missing the PHP-GD library.

Mostly, when we hear about PHP in WordPress, the first thing that we use to relate is HTML. But PHP is also used to create and edit image files. Image formats supported include GIF, PNG, JPEG, WBMP, and XMP.  In general, PHP allows uploading an image directly into the browser. And, it’s the GD library that makes image functions work.

How we fix WordPress image cropping error

We now know how the error looks. Moving on further let’s check on how our Support Engineers fix image cropping error for our customers.

As the first step of troubleshooting, we check the server’s PHP version along with the GD package.  If the GD package is missing, we install it. However, the GD installation steps differ depending on the server type.

For RedHat/ CentOS hosts, we run the command

 yum install php-gd

Or, if it is an Ubuntu server, GD installation works using

 apt-get install php-gd

Here, our Support Team also makes sure that the version of the WordPress package matches the PHP version of the host.

Finally, to make the newly installed GD package, the webserver needs a restart. We do this in the server by

/etc/init.d/httpd restart

After fixing the error, in the “Media Library,” the user can select the image and “Insert into post”.

Media library after fixing the error

[Need help in fixing WordPress error? We are here 24×7.]


In short, the main reason for the WordPress error cropping image will be missing the GD package on the server. Today, we saw how our Support Engineers check and fix image uploading error for our customers.

Leave a Comment

Your email address will not be published. Required fields are marked *

Social Share


Cheapest Web Hosting

Fasters Web Hosting Promo
Scroll to Top

Launch your Website at RS599

Create a professional website yourself with our domain hosting combo. Get Extra benefits at this Year end Sale with 10% OFF and Enjoy Amazing Deels on Shared Hosting!

Starting at Only RS599/Year

Year End Sale


Use Code STARTBIZ at Checkout.

Create an earning opportunity with A Web Hosting Business

Become reseller and start reselling domains, web hosting, ssl certificates and More.

45% OFF

Starting at RS399/Month


Use coupon: at the checkout.