You uploaded files by FTP, restored a backup, or moved images between folders, and the Media Library still looks the same. People often search to refresh WordPress media library data, hoping for a simple button. There is no such button in WordPress core, but there are five reliable ways to get the same result. This guide explains each, and when to use it.
Why the library does not update by itself
The Media Library shows records from your database, not the folder contents. When you upload through the dashboard, WordPress copies the file and creates a record. When you add files in other ways, such as FTP, no record is created. The files sit in wp-content/uploads, but the library has no idea they exist.
Understanding this saves a lot of time. A browser refresh will never help. The library needs new records.
Way 1: Do a simple page and cache refresh
Start with the easy check. Press Ctrl+F5, clear your browser cache, and disable any object cache for a moment. Sometimes the records exist, but a cached screen hides them. If new items still do not show, move on to the next way.
Way 2: Upload through the dashboard instead
For a few files, use Media > Add New. WordPress creates a record and every image size. This is the safest way when you only have a handful of files.
Way 3: Re-register files already on the server
If the files are already in the uploads folder, you do not need to upload them again. A recovery tool can scan the folder and create the missing records.
- Install Media Library Recovery Free.
- Go to Media > Media Recovery.
- Pick the images you want to add, and click recover.
- Check Media > Library.
The free version handles up to 10 images at a time from the default uploads folder. Pro removes the limit, supports other media types, and lets you set a custom uploads path. Our guide to the Media Explorer shows how to filter big folders.
Way 4: Regenerate image sizes
If the records exist but thumbnails look wrong or are missing, you need to rebuild the sizes, not the library. A thumbnail regeneration plugin recreates each size from the original file. This is common after a theme change that uses new image dimensions. Our post on how to regenerate the media library from the uploads folder explains how the two jobs differ.
Way 5: Use WP-CLI for large sites
Developers can use WP-CLI to import files from the server into the library. The wp media import command adds files as attachments. It is fast, but it needs command-line access, and it copies files, which can create duplicates. Test on a copy first.
Which way should you use?
| Situation | Best way |
|---|---|
| — | — |
| Cached screen only | Way 1 |
| A few new images | Way 2 |
| Files on server, not in library | Way 3 |
| Thumbnails missing or wrong size | Way 4 |
| Thousands of files, command-line access | Way 5 |
Mistakes to avoid
- Uploading the same files again by dashboard, which creates duplicates.
- Deleting the uploads folder to “reset” it.
- Running bulk changes without a backup.
- Forgetting to add alt text after files are re-registered.
Keep the library healthy
Add a short monthly routine. Check for orphaned files, remove unused media you are sure about, and back up the uploads folder. Our help article on backing up your uploads folder covers the backup step.
Refresh WordPress media library: common questions
Is there a refresh button in WordPress?
No. The library is a database list, and refreshing the screen does not create new records.
Why are my FTP uploads missing from the library?
FTP copies files only. WordPress does not create records for them, so they stay hidden until they are registered.
Will registering files create duplicates?
A good recovery tool adds records for files that are not yet listed and does not copy the files. A repeat upload through the dashboard does create copies.
How often should I clean up the library?
Once a month is plenty for most sites. Large stores may want a weekly check.
Conclusion
To refresh WordPress media library entries, remember that the library is a database list. If the files are on the server, re-register them. If only the sizes are wrong, regenerate them. For a few new files, just upload them again.
For the quickest fix when files already exist on the server, try Media Library Recovery Free.
