Title: Wisnoob Media Cleanup
Author: wisnoob
Published: <strong>October 13, 2026</strong>
Last modified: October 13, 2026

---

Search plugins

![](https://ps.w.org/wisnoob-media-cleanup/assets/banner-772x250.png?rev=3745023)

![](https://ps.w.org/wisnoob-media-cleanup/assets/icon-256x256.png?rev=3745023)

# Wisnoob Media Cleanup

 By [wisnoob](https://profiles.wordpress.org/wisnoob/)

[Download](https://downloads.wordpress.org/plugin/wisnoob-media-cleanup.1.1.0.zip)

 * [Details](https://wordpress.org/plugins/wisnoob-media-cleanup/#description)
 * [Reviews](https://wordpress.org/plugins/wisnoob-media-cleanup/#reviews)
 *  [Installation](https://wordpress.org/plugins/wisnoob-media-cleanup/#installation)
 * [Development](https://wordpress.org/plugins/wisnoob-media-cleanup/#developers)

 [Support](https://wordpress.org/support/plugin/wisnoob-media-cleanup/)

## Description

Wisnoob Media Cleanup scans your whole site to work out which media files are actually
used, and **where**. Instead of a bare “unused” label, every file shows the pages,
products, widgets and settings that reference it, with a **Find on page** button
that opens the page, scrolls to the image and highlights it.

**Please back up your site before deleting anything. Deleted files cannot be recovered.**

#### What it scans

 * Post, page and product content and excerpts (any post type), including block 
   attributes, `wp-image-123` classes and gallery shortcodes
 * Featured images and WooCommerce product galleries
 * Custom fields, including ACF image and gallery fields
 * Elementor page data
 * WooCommerce product category thumbnails and other term images
 * Widgets (classic and block), menus, Customizer settings, site logo and site icon
 * Block theme templates, template parts and global styles
 * Additional CSS
 * User profile images

#### Safety first

 * Scans run in small steps, so large libraries never time out, and deleting stays
   disabled until a scan has fully finished.
 * Files the scan found in use are never deleted by “Delete All Unused”.
 * Right before deleting, Wisnoob Media Cleanup re-checks content edited since the
   scan, so an image you just added to a page is skipped.
 * Every delete asks for confirmation.

#### Duplicate finder

The Duplicates tab finds:

 * **Exact duplicates:** byte-identical files uploaded more than once
 * **Scale variants:** `icon.png`, `icon@2x.png`, `icon-3x.png`
 * **Visual duplicates:** the same picture in a different size, format or with small
   edits

Each file shows whether it is used, so you can keep the one your pages rely on.

#### Wisnoob Media Cleanup Pro

Want an undo? [Wisnoob Media Cleanup Pro](https://checkout.freemius.com/plugin/40992/plan/71073/)
is an optional paid add-on:

 * **Quarantine instead of permanent delete:** removed files are kept for 30 days
   and can be restored with one click.
 * **Merge duplicates:** keep one copy and every page, featured image and gallery
   that used the others is updated automatically.

Everything described above works without it.

#### What it can’t see

Files referenced only from theme or plugin PHP code, hard-coded in theme CSS files,
or linked from other websites are not detected. Check the “Find on page” result 
before deleting anything you are unsure about.

## Screenshots

[⌊Summary and media grid filtered to unused files⌉⌊Summary and media grid filtered
to unused files⌉[

Summary and media grid filtered to unused files

[⌊"Used in" details with Find on page⌉⌊"Used in" details with Find on page⌉[

“Used in” details with Find on page

[⌊A file highlighted on the front end⌉⌊A file highlighted on the front end⌉[

A file highlighted on the front end

[⌊Duplicate finder⌉⌊Duplicate finder⌉[

Duplicate finder

## Installation

 1. Upload the plugin to `/wp-content/plugins/wisnoob-media-cleanup/`, or install it
    from **Plugins  Add New**.
 2. Activate it.
 3. Go to **Media  Wisnoob Media Cleanup** and click **Scan Media Library**.

## FAQ

### Is it safe?

Wisnoob Media Cleanup only deletes files you select, after confirming, and only 
after a complete scan. It cannot see every possible reference (see “What it can’t
see”), so always keep a backup.

### Does it work with page builders?

Elementor is scanned directly. Gutenberg, Classic Editor, WPBakery and Divi content
is read from the post content, which covers image URLs and the image IDs those builders
store.

### Will it slow down my site?

No. Scanning only happens when you click Scan in the admin. Nothing runs on the 
front end except the “Find on page” highlighter, and only for logged-in administrators
who opened a page from Wisnoob Media Cleanup.

### What happens to my data if I uninstall?

Uninstalling removes Wisnoob Media Cleanup’s own table and settings. Your media 
files are not touched.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Wisnoob Media Cleanup” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ wisnoob ](https://profiles.wordpress.org/wisnoob/)

[Translate “Wisnoob Media Cleanup” into your language.](https://translate.wordpress.org/projects/wp-plugins/wisnoob-media-cleanup)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/wisnoob-media-cleanup/),
check out the [SVN repository](https://plugins.svn.wordpress.org/wisnoob-media-cleanup/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wisnoob-media-cleanup/)
by [RSS](https://plugins.trac.wordpress.org/log/wisnoob-media-cleanup/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.1.0

 * Scans now run in resumable steps with real progress, so large sites no longer
   time out.
 * Deleting is disabled until a scan fully completes, and files found in use are
   skipped unless you confirm.
 * Re-checks content edited since the scan right before deleting.
 * Detects images referenced by ID: gallery shortcodes, image/gallery/cover blocks,
   ACF galleries, WPBakery, block-theme site logo, WooCommerce category thumbnails
   and placeholder.
 * Scans product short descriptions, templates, template parts, global styles, term
   meta and user meta.
 * Duplicate scan runs in steps and caches file hashes.
 * “Space recoverable” now includes thumbnails.
 * Summary figures load correctly when returning to the page.
 * Selections reset when switching tabs, filters or searching, so hidden files can’t
   be deleted by accident.
 * Escape closes the details window; all interface text is translatable.
 * Works on PHP 7.4.

#### 1.0

 * Initial release.

## Meta

 *  Version **1.1.0**
 *  Last updated **1 day ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **7.1.3**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [cleanup](https://wordpress.org/plugins/tags/cleanup/)[duplicate images](https://wordpress.org/plugins/tags/duplicate-images/)
   [media](https://wordpress.org/plugins/tags/media/)[media library](https://wordpress.org/plugins/tags/media-library/)
   [unused media](https://wordpress.org/plugins/tags/unused-media/)
 *  [Advanced View](https://wordpress.org/plugins/wisnoob-media-cleanup/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/wisnoob-media-cleanup/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/wisnoob-media-cleanup/reviews/)

## Contributors

 *   [ wisnoob ](https://profiles.wordpress.org/wisnoob/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/wisnoob-media-cleanup/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://paypal.me/toast415)