Why Won't an Image Upload in the Elementor Editor?

Why This Happens

Elementor's image widget and media picker use WordPress's own upload and media library system rather than a separate mechanism, so upload failures generally trace back to standard WordPress/server limits rather than anything Elementor-specific. Display failures after a successful upload point more toward a corrupted file, a missing generated thumbnail size, or the editor showing outdated cached data.

Common Causes

• The file exceeding the server's maximum upload size (set via upload_max_filesize and post_max_size in PHP configuration), a very common limit on shared hosting.
• An unsupported or blocked file format, particularly newer formats like WebP or AVIF on an older WordPress/server setup not yet configured to allow them.
• A corrupted image file that uploaded but failed WordPress's internal processing to generate proper thumbnails.
• Insufficient file/folder permissions on the uploads directory, preventing the file from actually being written to disk.
• Browser or editor caching showing an outdated state after the image was actually uploaded successfully.

How to Fix It

1. Check the file size and format against the server's configured limits, resizing or converting if needed.
2. Increase PHP upload limits if legitimate files are being rejected for size.
3. Confirm uploads folder permissions are correctly set for WordPress to write to.
4. Clear browser and site caching, then refresh the editor.
5. Re-upload the file after ruling out corruption, testing with a different image if the issue persists.

Telling the causes apart

1. Upload the same file from Media → Add New. If it fails there too, Elementor isn't involved: it's a server limit, permissions or a problem with the file. If it works there, the cause is the editor session — often an expired login in a tab that has been open for a long time. Reload the editor and try again.
2. Read the actual message. "Exceeds the maximum upload size for this site" is a PHP limit. "The uploaded file could not be moved to wp-content/uploads" points to permissions or a full disk. "Post-processing of the image failed likely because the server is busy or does not have enough resources" is an image-processing or memory limit.
3. Check disk space and quota. A hosting account that has reached its storage limit fails uploads in ways that look like a WordPress problem.
4. Try a different image. If one file fails and others succeed, the file is the problem; re-export it from the original rather than renaming it.

A note on large photos

A photo can be small in kilobytes and still fail because its pixel dimensions are huge. WordPress has to generate several resized copies, and the memory needed depends on the pixel count, not the file size. Resizing very large originals before uploading avoids the failure and keeps pages lighter. WordPress also scales down images wider than 2,560 pixels by default, so the extra resolution is rarely used anyway.

Need a stubborn media upload issue diagnosed and fixed? See Elementor bug fix.