Skip to main content

Search

Type a word or a question to search the help articles.

My images won't upload, or upload and then show as failed

In this story

Where: Media

Open this page: admin.<your-site>/media (replace <your-site> with your site address)

Find your message

MessageFix
"{name} is too large. Images can be up to {maxMb} MB."Make the photo smaller and upload it again.
"{name} is not a supported image type."Use JPEG, PNG, WebP, AVIF or GIF.
"This file type can’t be uploaded. Use a JPEG, PNG, WebP, AVIF, GIF, HEIC, TIFF or BMP image."Save the file in one of these types.
"Upload failed. Check your connection and try again."Check your internet and try again.
"Your photo storage is full ({used} of {limit} MB). Delete unused images or ask for more space."Delete images you don't use. See Library.
"This image is too big to process. Use an image of at most {x} megapixels and {y} pixels per side."Resize it before upload.
"This server can’t read {type} images. Save the photo as JPEG and upload it again."Export as JPEG.
"The image is still processing. Try again in a moment."Wait for Preparing sizes… to finish.
"The uploaded file is not a {type} image."The file name and the real file type differ. Save it again as the right type.
"This file was not saved: it is not the type it claims to be, hides other content, or contains malware."Do not use this file. Scan your device.
"The malware scanner is not answering. Try the upload again in a minute."Wait a minute and try again.
"Photo storage is being set up for your site. Uploads will work as soon as it’s ready — your articles can still be published without photos."Wait. This is a calm notice. Publish without photos meanwhile.

Good to know

  • Accepted types. The screen says "JPEG, PNG, WebP, AVIF or GIF, up to {maxMb} MB". TIFF and BMP become PNG. iPhone HEIC photos become JPEG when your server can read them. SVG graphics are cleaned of scripts before they are stored. See Supported image formats.
  • Large photos from your phone are resized on your device before upload to save data.
  • Resumed uploads. If your connection drops, the screen says "Connection is back. Upload continues."
  • Limits. What you can upload is set by your plan and your server. See File size limits.
  • Images from a web address. An address must be a public https:// address of an image. Otherwise you see "This address can’t be used. Use a public https:// address of an image."
  • Free image libraries. If you see "{source} needs your site’s API key first (Media settings)", add the key in Media settings.

Questions

Frequently asked questions

An image uploaded but looks blurry.

The library warns "Low resolution: it may look blurry on large screens." Upload a larger original.

The upload says Failed in the library.

The status Failed means the image could not be prepared. Delete it and upload it again in a supported type.

Can I add alt text?

Yes. The library asks for it: "Add alt text so everyone can understand the image."

Feedback

Was this helpful?

Also available in

Still need help?