fbpx
Image thumbnail

Fix the WordPress Error: “Post-Processing of the Image Failed Likely Because the Server is Busy…”

Occasionally, you might see the following error when uploading an image to the Media Library. The issue can also occur when uploading an image in a Gutenberg block, or page builder image widget or image area, etc.:

Post-processing of the image failed likely because the server is busy or does not have enough resources. Uploaded a smaller image may help. Suggest maximum size is 2500 pixels.“Post-processing of the image failed likely because the server is busy or does not have enough resources. Uploaded a smaller image may help. Suggest maximum size is 2500 pixels.”

The error may occur even when the image being uploaded is considerably smaller than 2500px.

The error is related to how WordPress 5.3+ handles uploaded images with very large dimensions.

It is not uncommon for users to upload images directly off a camera. Any digital camera with a sensor over 6-megapixels (MP) will commonly yield images over 2500 pixels on the long edge. These images are much larger resolution that commonly needed for the web. Even a new 2K monitor’s full width is only 2560 pixels. A 4K monitor has a width of 3840 pixels. The most common screen resolutions for your website visitors are much, much smaller. So, when uploading an image over 2500 pixels on the longest dimension, WordPress will attempt to reduce the image to ~2500 pixels and save that version as the “Full” sized image version.

If that process was flawless, you probably wouldn’t be reading this post. So, how to fix the error:

Basic Troubleshooting

Before venturing on too far, double check some of the easiest potential causes. These probably won’t fix the issue, but you should get them out of the way just in case:

  1. Is your image larger that 2500 pixels on the long edge? If so, try reducing its size prior to upload.
  2. Try the upload in a different web browser.
  3. Check your filename. Are there any odd characters there, or is it just plain alphanumeric (A-Z/a-z and 0-9) with perhaps underlines or hyphens? On a side note, generally I prefer rename files to use filenames that are representative of the image’s usage context and content, e.g., header-my-page-name.jpg for the header image of a given page, footer-background.jpg for a footer background (go figure), or about-mr-lastname.jpg for a headshot on an About page. No filenames right off the camera, no odd unicode characters, no random characters carried over from other usages or file systems.
  4. Try peforming a hard refresh for the edit page in question (where the editor is shown, not the public, published page). Typically, a hard refresh would be Control + F5 in Chrome, Control + Shift + R in Firefox or Edge, Command + R in Safari.
  5. Try emptying your web browser’s cache at least for the site in question.

Common Fixes

  1. Bypass the check for large images. This is the solution that tends to work for me. Technically, it’s a workaround and not a fix. Add the following to the functions.php of your WordPress theme or child theme: add_filter( 'big_image_size_threshold', '__return_false' );
  2. Install and activate the WordPress plugin “Disable ‘BIG Image’ Threshold” plugin. This plugin basically implements the above fix and may be more convenient for some folks.

When That Doesn’t Work: “Advanced” Troubleshooting

These are advanced in the sense of taking a bit more time, a bit more access, or a bit more potential impact on your site’s uptime.

  1. Use GD Library instead of ImageMagick for image processing. Add the following to your WordPress theme’s function.php file. add_filter('wp_image_editors', function($editors) {
    return ['WP_Image_Editor_GD', 'WP_Image_Editor_Imagick'];
    })
  2. Verify your upload limit. The web server typically has each account set to a maximum file upload size, such as 10MB-128MB. Is the maximum file upload size set to something small, possibly in the vicinity of your large image’s size, e.g. 1-2MB? Generally, you will need to ask your host about this setting. You can try to set this value in your php.ini or .htaccess file, but in most cases any values set in those file will be overidden by the web server’s settings.
  3. Check your hosting account’s memory usage. If your account received high amounts of traffic or is involved (perhaps temporarily) in memory or CPU intensive activities such as backups, etc., it may be legimately running out of resources. In my experience this is seldomly the cause, but check.
  4. Swap your current PHP version. You may try to set the PHP version used on the site to a different version, for example PHP 7.3 instead of versions 7.2, 7.4 or 8.0, etc. Be careful in doing so in case the PHP version change causes issues with the proper function of the site. Ideally, test this only if you have direct access to the PHP setting, or have extremely responsive technical support from your host (that is, don’t file a ticket for a potentially site breaking PHP version change if the average turnaround time on tickets is more that a few minutes or whatever you consider acceptable downtime.).
  5. Swap to a basic WordPress theme and retest the upload process. It’s probably best to move your site to a staging server first and test there unless you are not yet in production.

Thoughts?

I’d love to hear if you have solved this issue with another method. Drop me a comment below. Thanks!

Fix the WordPress Error: \
Vance Bell

Vance Bell

Hi there, glad you made it! I'm Vance Bell, a freelance web designer/developer and frequent marketing consultant.

Monday to Saturday I help businesses and organizations grow attention and revenue. Sometimes on Sunday I take a break and binge watch Netflix.

Owner of Pixel Engine, a Philadelphia-based web design and online marketing studio.

If you'd like to hire me, I'd love to hear from you. If you just have a question, feel free to ask.

Comments

  • January 16, 2022
    reply

    Kera McHugh

    The really annoying part is when this happens uploading EVERY image, because I generally pay close attention and do not bother trying to upload things bigger than 2500px! Just today, i had a group of images, all 100% smaller than that, and every one of them kicked the error. However, as usual, I saved my updates, reloaded the page and opened the media library, and voila! there they all were.

    So… is there something in particular that would best to stop this false error from happening? because it’s particularly annoying, and happens on multiple sites.

    • April 26, 2022
      reply

      James

      Hi Kera, everything you just said is happening to me. The plugin does not help resolve it. It does happen on multiple sites, and its annoying as all heck.

  • February 7, 2022
    reply

    Stuart Knox

    Just a simple empty of the cache worked for me. Why didn’t I think of that? Thank you.

  • March 11, 2022
    reply

    Lakshmi Prabha Ramesh

    A Simple refreshed helped me with this issue.
    Thank you!

  • March 30, 2022
    reply

    John Norton

    Well look at that, Vance to the rescue with a #2 google result.

  • April 27, 2022
    reply

    James

    As a follow-up, changing the PHP version worked to resolve the issue. in cPanel, under Software, PHP Version went from 7.4 to 8.0 Be sure to redo your options for max upload size etc. Thanks for this article. It made a difference and I appreciate that.

  • May 1, 2022
    reply

    Tyler Dietich

    I had an apostrophe in my file name. I took it out and that’s what fixed it.
    Thank you!

  • May 16, 2022
    reply

    Anka

    Thank you so much for your help and useful tips 🙂

  • July 15, 2022
    reply

    Dermot

    I fixed this by changing the Plugin/ImageMagick settings and removed all the options that said “None (use WP instead)”. Basically allow ImageMagick to handle the images.

  • August 13, 2022
    reply

    Arham

    Just upload it via incognito. It worked for me.

Post a Comment