Media Uploads Failing
A Media Library upload may fail before it begins, stop during processing or finish without creating the expected image sizes. The exact message and whether every file is affected can help narrow down the cause.
Check the file first
- Compare its size with the maximum shown on the upload screen.
- Use a supported file type and a simple descriptive filename.
- Try a smaller image exported again from a trusted image editor.
- Check whether another file of the same type uploads successfully.
Check the website environment
- Confirm that the hosting account has available storage.
- Review PHP upload and post-size limits under PHP and Server Settings.
- Check whether WordPress can write to the current uploads directory.
- Review hosting and WordPress logs for an error at the upload time.
- Note any security, image optimisation or hosting change made before uploads began failing.
When the upload reaches WordPress but processing fails
Large image dimensions, memory limits or an unavailable image-processing library can prevent WordPress from creating thumbnails. Keep the original file and the displayed message. Submit a Fix Request if you want a developer to identify the failed step.
Common questions
Frequently Asked Questions
Why can I upload a document but not an image?
The image may exceed dimension or memory limits, use an unsupported format or fail while WordPress creates its additional image sizes.
What does the maximum upload size mean?
It is the largest individual file WordPress currently accepts. Hosting and PHP settings can impose additional limits on the overall request.
Why did uploads stop when hosting storage became full?
WordPress needs space for the original upload, generated image sizes and temporary processing. Freeing or increasing storage may be required before uploads can complete.
Should I change upload-folder permissions myself?
Only when you understand the host's required ownership and permission model. Incorrect permissions can prevent access or expose files, so ask the host or a developer when unsure.