I am setting the header image in WordPress and when I click on the crop button, it shows me the following error:

There has been an error cropping your image.

enter image description here


I solved this installing the next library

sudo apt-get install php5-gd -> for php5

sudo apt-get install php7.0-gd -> for php7

sudo apt-get install php7.2-gd -> for php7.2

| improve this answer | |
  • Didn't even have to refresh the page after install. Thanks – KhoPhi Feb 7 '19 at 18:48
  • On CentOS it's yum install php-gd, for the interested. – bviktor Mar 22 '19 at 12:32

There is too little information to be completely sure, but usually this error occurs when WordPress cannot find the graphic library which should be installed on your server. So you should check with your provider to see if Imagick and/or GD are installed.

You can also add this little snippet of code in your functions.php file to make sure WordPress looks for both (often it only looks for Imagick):

add_filter ('wp_image_editors', 'wpse303391_change_graphic_editor');
function wpse303391_change_graphic_editor ($array) {
    return array( 'WP_Image_Editor_GD', 'WP_Image_Editor_Imagick' );

This snippet will look for GD first and then for Imagick. The latter gives better quality, but uses more memory, which can also lead to server errors.

| improve this answer | |
  • Is there a list of these "extra" requirements anywhere? wordpress.org/about/requirements doesn't mention any PHP libraries that need to be installed. – aidanh010 Oct 18 '18 at 19:04
  • Wordpress assumes there is a complete PHP install on the server. It's not something "extra". – cjbj Oct 18 '18 at 20:53

I had encountered the same issue with my blog, after searching for a while found out that it was because GD library for PHP which was not installed on the server

Since my server is hosted on CentOS, to find the GD Library package within CentOS repository

$ sudo yum list available | grep 'gd'

Identify GD Library package name and install it

$ sudo yum install php-gd

Restart apache service

$ sudo service httpd restart

A detailed article can be found here with command output screenshots

| improve this answer | |

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.