Demo Images or Manually Uploaded Images Appear Broken in Media Library

If demo images are imported but appear broken in Media, or if even manually uploaded images do not display correctly, the issue is usually not related to the theme.

In most cases, this happens because WordPress is using a custom upload path that does not exist on the server, has incorrect permissions, or is not configured correctly.

This can prevent images from being saved, processed, or displayed correctly, even if they appear as uploaded in wp-admin.

How to Check the Media Upload Path

Go to:

Settings > Media

or open this admin page directly:

/wp-admin/options-media.php

Check if there is a custom value added in the upload path field.

By default, WordPress should upload files to:

/wp-content/uploads/

If a custom upload path is set, and that folder has incorrect permissions or does not exist correctly on the server, WordPress may upload images in a broken way.

What to Do

Remove the custom upload path and let WordPress use the default uploads folder.

After removing the custom path:

1. Save the Media settings.
2. Upload one image manually from Media > Add New.
3. Confirm that the image displays correctly in the Media Library.
4. Delete the broken demo images if needed.
5. Re-import the demo content.
6. Check the Media Library and front-end pages again.

What We Found in This Case

In this setup, the website had a custom media upload path saved in WordPress.

That path had incorrect server permissions, which caused uploaded images to appear broken.

After removing the custom path from:

/wp-admin/options-media.php

WordPress started using the standard uploads folder again, and image uploads worked correctly.

We then:

• deleted the broken images from Media
• re-imported the demo content
• confirmed that all images were loading correctly

Important

If images are broken even when uploaded manually through the standard WordPress Media Library, this is usually a WordPress or server configuration issue, not a theme issue.

If removing the custom upload path does not fix the issue, ask your hosting provider to check:

• folder permissions for /wp-content/uploads/
• folder ownership for /wp-content/uploads/
• PHP memory limit
• disk space and inode limits
• temporary upload folder permissions
• image processing libraries such as GD Library or ImageMagick

Message to Send to Hosting Support

Hello,

Images uploaded in WordPress appear broken in Media Library.

Please check the following:

1. The current WordPress upload path
2. The permissions and ownership for /wp-content/uploads/
3. Whether a custom upload path exists and points to a valid writable folder
4. Disk space and inode limits
5. PHP memory limit
6. PHP temporary upload folder
7. GD Library or ImageMagick availability

Please confirm that WordPress can write and process images correctly in the default uploads folder.

Thank you.

Conclusion

If demo images are broken after import, always test one manual image upload first.

If manually uploaded images are also broken, check the Media upload path and the server permissions for the uploads folder.

A wrong custom upload path can break all image uploads, including manual uploads, and can make the demo import appear incomplete even when the theme is working correctly.