HomeExtensionsScriptsWordPressDocsSupport
WordPress pluginv2.0.0

Unused Media Review

Find the media nothing on your site uses, review it with thumbnails and remove what you pick into an archive you can restore.

This guide covers installing and using Unused Media Review by Quintaphon (version 2.0.0), a free plugin that finds the media nothing on your site uses, shows it with thumbnails and removes what you pick into an archive you can restore. Use it for the first cleanup and as a reference for every screen.

Tip

The plugin lives under Media > Unused Media. It has four screens: Overview, Review, Kept and Archive.

Overview

Over the years a Media Library fills up with images from deleted posts, replaced logos, test uploads and files nobody remembers. Unused Media Review handles them in a safe order:

  • Scan: reads your posts, custom fields, settings and theme, then lists every media item nothing points to. Nothing is changed.
  • Review: you see each item with its thumbnail and decide. Keep it, or select it for removal.
  • Remove: each item is checked again, then moved with its files and database rows into an archive.
  • Restore or delete: an archive brings the items back with the same IDs, or frees the space for good.

Requirements

ItemNeeded
WordPress5.8 or newer (tested up to 7.1)
PHP7.2 or newer
UserAn administrator (the manage_options capability)
DiskRoom in the uploads folder for the archive. Files are moved, not copied, so an archive takes no extra space.

Install

  1. Download unused-media-review.zip.
  2. In WordPress go to Plugins > Add New Plugin > Upload Plugin, choose the file, click Install Now and activate it.
  3. Open Media > Unused Media.

Activating the plugin changes nothing on your site. It only adds the screen for administrators.

Back up first

Take a backup of your database and the uploads folder before removing media from a live site, as you would before any bulk change.

Overview screen

The Overview shows the number of media items, how many unused items wait for review and their size on disk, how many items you kept and the space the archives hold. Below that it lists what the scan checks and the details of the last scan.

Unused Media Review Overview screen
Overview: media items, unused items, kept items and the archive.

What counts as used

A media item counts as used when any of these point to it, by link, file name or ID:

  • The content or excerpt of a post, page or product: inserted images, image blocks, links, galleries and gallery shortcodes.
  • A featured image or a WooCommerce product gallery.
  • A custom field, including ACF fields and page builder data such as Elementor.
  • A category or term image, or a user picture.
  • Site settings: site icon, custom logo, header and background images and widgets.
  • Your active theme and its parent theme, when a file is named in the theme's PHP, CSS, JavaScript or JSON files (optional, on by default).

Posts in every status count, including drafts, scheduled posts, private posts and posts in the trash. Revisions and auto-drafts do not.

Scan

Open Review, check the options and click Scan for unused media.

OptionDefaultWhat it does
Look in theme filesOnCounts files the active theme links to by name, for example a logo or a background in its CSS.
Skip media added in the last 7 daysOnNew uploads may belong to a post that is still being written, so they are left out.
Count media attached to a post as usedOffMedia uploaded while editing a post is "attached" to it, even if the post does not show it. Turn on to keep all of those.

The scan runs in seven short steps (posts, custom fields, term data, user data, settings, theme files, check), so it never hits a PHP time limit. Keep the tab open; Stop ends it after the current step. When it finishes you see how many items are unused, their size and what was left out.

Scan options and result
Scan: 11 unused items found, one recent upload left out.

Review the results

The Unused media grid shows each item with its thumbnail, file name, type, dimensions, size, upload date and, when it has one, the post it was attached to. Click a file name to open the item in WordPress in a new tab.

  • Filter by Images, Video, Audio, Documents or Other, and search by title or file name.
  • Tick items one by one, or Select this page. A link then offers to select every result that matches the filter, across all pages.
Review grid with thumbnails and selection
Review: three items selected for removal.

Keep items

Select items and click Keep when you want to hold on to them. Kept items leave the review list and later scans leave them out. The Kept screen lists them with the same grid; select one and click Review again to put it back in the next scan.

Remove to the archive

  1. Select the items and click Remove to archive, then confirm.
  2. The plugin first reads the posts changed since the scan, the featured images and the site settings again. An item that is used by then is left alone.
  3. Each remaining item is removed from the Media Library. Its files move into the archive in their original folder layout, together with its database rows: the media item, its custom fields (alt text, image data) and its terms.
  4. A report shows how many items moved and lists any that were left alone.
Confirmation before removing to the archive
Each item is checked again before it is removed.
Removal report with one item left alone
Removal report: 10 items archived, one left alone because a new post uses it.

Archive and restore

Each removal creates an archive in wp-content/uploads/unused-media-review-backup/. The Archive screen lists them with the date, the number of items and files and the size.

  • Restore brings every item back to the Media Library with its files, title, alt text, captions and terms. Items get their old ID when it is still free, so links by ID keep working. If a file can not go back, for example because a new file now has its name, the archive is kept so nothing is lost.
  • Delete frees the space for good. You type DELETE to confirm.
Archive list with Restore and Delete
Archive: one removal with Restore and Delete.

When to delete an archive

Browse your site for a few days after a removal. When every page looks right, delete the archive to get the space back.

Delete for good

Tick Delete permanently instead of keeping an archive above the grid to skip the archive. The items and their files are deleted from the Media Library and the server. This needs DELETE typed in the dialog and can not be undone; each item is still checked again first.

Typed DELETE confirmation
Deleting an archive or deleting media straight away needs DELETE typed first.

Your data

  • The plugin stores the scan options, the last scan result, the kept list and the state of a running removal or restore in a few options. It adds no database tables.
  • It adds nothing to the front end, sends no data anywhere and loads no external files.
  • Deleting the plugin removes its options. Archives stay on disk because they hold your files: delete them under Archive first, or remove the folder yourself.

Troubleshooting

ProblemWhat to do
An image I use is listed as unusedA plugin or theme may store it in a way no scan can see. Click Keep on it. If you removed it already, restore the archive.
An image I never use is not listedSomething points to it: a link, its file name, or its ID in a custom field or setting. Uploads from the last 7 days and kept items are left out too.
Something is missing on the site after a removalClick Restore on that archive under Archive.
An item was "left alone"Something started using it after the scan. Nothing to do; scan again for a fresh list.
A scan stopped halfwayStart a new scan. A scan only reads, so nothing needs to be undone.
Images on a CDN or cloud storageRemoving an item moves the files in your uploads folder. Remote copies are handled by your offload plugin, if it reacts to deleted media.

Changelog

  • 2.0.0 (November 9, 2026): Rebuilt for every site: a full scan of posts, custom fields, term and user data, settings, widgets and theme files. A new screen under Media > Unused Media with Overview, Review, Kept and Archive; a review grid with thumbnails, filters, search and select all; kept items; removals go to an archive that restores with the same IDs; every item is checked again before removal; deleting for good needs DELETE typed. Now licensed under the GPL, version 2 or later.
  • 1.0.0 (October 8, 2026): First release, made for one site with a fixed list of items.

Need help?

Questions about setup or a feature request? Contact us on our support page. You can also download the latest version (v2.0.0) here.