How to Troubleshoot and Fix WordPress Media Library Images Not Loading Thumbnails

Learn how to diagnose and fix WordPress Media Library images that show blank, broken, or endlessly spinning thumbnails while keeping your live site safe.

Overview

If your WordPress Media Library shows blank squares, broken icons, or endlessly spinning loaders instead of image thumbnails, it usually points to a problem with file paths, permissions, or server resources. This guide walks you through safe, step-by-step checks you can perform (or share with your developer) to restore thumbnails without risking your live site.

Common Symptoms

• Media Library grid view shows grey boxes or spinner icons instead of thumbnails.
• List view shows file names but no preview image.
• New uploads appear as broken images, but the upload completes without an error.
• Images display on the front end, but not inside the Media Library.

Step 1 – Confirm the Issue and View in List Mode

First, confirm whether the problem is only with thumbnails or with the actual image files.

1. In WordPress, go to Dashboard ? Media ? Library.
2. At the top left of the Media Library, click List view (icon with lines).
3. Click on an image title to open the Attachment details panel.
4. Click the Copy URL to clipboard button and open that URL in a new browser tab.

What You Should See

• If the image opens in the new tab but not as a thumbnail, the issue is with thumbnail generation or admin display, not the original file.
• If the image does not open in the new tab (404 or error), the issue is with file paths, uploads, or permissions.

Step 2 – Check Browser Console for Errors

Next, check whether the browser is reporting blocked or missing thumbnail files.

1. Open Dashboard ? Media ? Library in Grid view.
2. Right-click anywhere on the page and choose Inspect (or Inspect Element).
3. Open the Console tab.
4. Reload the page and watch for red error messages.

Common Console Messages

• 404 Not Found on files under /wp-content/uploads/ – likely wrong paths or missing files.
• 403 Forbidden – file permissions or security rules blocking access.
• Mixed content warnings (HTTP vs HTTPS) – thumbnails blocked because they are not loading over HTTPS.

Step 3 – Verify Uploads Folder Permissions

Incorrect file and folder permissions can prevent WordPress from creating and serving thumbnails.

If You Have Hosting File Manager Access

1. Log in to your hosting control panel (cPanel, Plesk, or similar).
2. Open File Manager and navigate to public_html/wp-content/.
3. Locate the uploads folder.
4. Right-click uploads and choose Permissions or Change Permissions.

Recommended Permissions

• Folders (including uploads and its year/month subfolders): typically 755.
• Files (images inside uploads): typically 644.

If you are not comfortable changing permissions, note what you see and share it with your developer or Compass Production support.

Step 4 – Test a Fresh Image Upload

Now test whether WordPress can properly process a new image.

1. Go to Dashboard ? Media ? Add New.
2. Upload a small JPG or PNG image (under 1 MB).
3. After upload, click the image to open its details.
4. Check whether the preview loads correctly in the right-hand panel.

What You Should See

• If the new image preview works but older thumbnails are broken, the issue may be with previously generated thumbnails or a past plugin/theme conflict.
• If the new image also fails to show a preview, the issue is likely global (server, permissions, or configuration).

Step 5 – Temporarily Disable Image Optimization / CDN Plugins

Image optimization, lazy loading, or CDN plugins can sometimes interfere with how thumbnails are served in the admin area.

Common Plugin Types to Check

• Image compression/optimization plugins.
• CDN or performance plugins that rewrite image URLs.
• Security plugins that block certain file types.

Safe Testing Process

1. Go to Dashboard ? Plugins ? Installed Plugins.
2. Identify any plugins related to images, performance, or CDN.
3. Deactivate one plugin at a time.
4. After each deactivation, refresh Dashboard ? Media ? Library and check thumbnails.

If thumbnails reappear after disabling a specific plugin, that plugin is likely rewriting or blocking thumbnail URLs. Share this information with your developer or Compass Production so they can adjust its settings or replace it.

Step 6 – Regenerate Thumbnails Safely

If original images exist but their thumbnail sizes are missing or corrupted, regenerating thumbnails can fix the Media Library display.

Before You Start

• Ensure you have a recent full site backup (files and database).
• Perform this during a low-traffic time if your site is large.

How to Regenerate Thumbnails

1. Go to Dashboard ? Plugins ? Add New.
2. Search for a reputable thumbnail regeneration plugin (your developer or Compass Production may recommend a specific one).
3. Install and activate the plugin.
4. Follow the plugin’s menu path (often under Tools or Settings).
5. Choose to regenerate thumbnails for all images or start with a small batch to test.

What You Should See

• A progress bar or log showing thumbnails being regenerated.
• After completion, Media Library thumbnails should begin appearing normally.

Step 7 – Check for Memory or Timeout Issues

On some hosting plans, limited PHP memory or short timeouts can prevent WordPress from generating thumbnails, especially for large images.

Signs of Resource Limits

• Media Library loads partially, then stops.
• Regenerating thumbnails fails or stops mid-way.
• Error logs mention Allowed memory size exhausted or maximum execution time exceeded.

What You Can Do

• Ask your host or developer to review PHP memory_limit and max_execution_time.
• Upload images that are properly compressed and resized before uploading (e.g., 2000px wide or less).
• Regenerate thumbnails in smaller batches if your library is large.

Step 8 – Confirm URLs Match Your Current Domain and HTTPS

If your site was recently migrated, changed domains, or switched to HTTPS, old thumbnail URLs may still point to the previous domain or HTTP version.

Quick Checks

1. Open an image in the Media Library and copy its URL.
2. Confirm the URL uses your current domain and https://.
3. If you see an old domain or http://, a search-and-replace in the database may be required (developer task).

When to Contact Compass Production Support

If you have worked through the steps above and thumbnails are still not loading, gather the following details before contacting support:

• Whether images open correctly when you visit their direct URLs.
• Any red errors from the browser console (copy/paste or screenshot).
• Recent changes: new plugins, theme changes, migrations, or HTTPS changes.
• Approximate number of images in your Media Library.

Sharing this information helps our team quickly pinpoint whether the issue is related to hosting, configuration, or a plugin/theme conflict.

Summary

Media Library thumbnails usually fail due to missing files, incorrect permissions, plugin conflicts, or resource limits. By confirming that original images exist, checking browser errors, testing plugins, and regenerating thumbnails carefully, you can often restore thumbnails without disrupting your live site. When in doubt, pause and involve Compass Production support so we can help you resolve the issue safely.

Video