WP Manifestindependent plugin directory
manifest / media / media-janitor

Media Janitor

WordPress plugin to find and safely remove unused media files. Scans all content sources and shows exactly where each file is used.

by Wisnu · github.com/wisnuub/media-janitor · website

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/wisnuub/media-janitor/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/wisnuub/media-janitor ↗

v1.0 — Find and safely remove unused media files from your WordPress site.

⚠️ PLEASE BACK UP YOUR SITE BEFORE USING THIS PLUGIN. Deleted media files cannot be recovered.

A free, lightweight WordPress plugin that scans your entire site to identify which media files are actually used — and where — so you can confidently clean up the unused ones without breaking anything.

How It Works

Instead of blindly flagging media as "unused", the plugin:

  1. Scans 10 different content sources (posts, pages, widgets, theme settings, page builders, etc.) to build a complete usage map.
  2. Records exactly where each media file is referenced — with clickable links.
  3. Lets you click "Find on page" to open the actual page and auto-scroll + highlight the media element, so you can visually confirm before deleting.

Features

  • Scans post/page content (all post types)
  • Scans post meta & custom fields
  • Scans featured images
  • Scans WooCommerce product galleries
  • Scans widgets
  • Scans Customizer / theme mods (site logo, site icon, etc.)
  • Scans options table
  • Scans navigation menu items (PDF links, etc.)
  • Scans Elementor page builder data
  • Scans Additional CSS (background images)
  • Categorized view: Images, Documents, Videos, Audio
  • Filter by Used / Unused status
  • Search by filename
  • "Find on page" — opens the page and scrolls to the exact media element with a pulsing highlight
  • Navigation arrows when multiple matches exist on a page
  • Summary dashboard with total, used, unused counts & recoverable space
  • Bulk delete selected or all unused media
  • Clean admin UI under Media → Media Janitor

Requirements

  • WordPress 5.8+
  • PHP 7.4+

Installation

  1. Clone or download this repo
  2. Upload the folder to /wp-content/plugins/
  3. Activate in Plugins
  4. Go to Media → Media Janitor and hit Scan Media Library

Changelog

v1.0

  • Initial release
  • Full media usage scanner (10 content sources)
  • Categorized media grid with filters & search
  • Usage detail modal with "Find on page" highlighting
  • Bulk & selective deletion
  • Summary dashboard with space recovery estimate

Roadmap

  • [x] Scan posts, meta, widgets, theme mods, menus, Elementor, custom CSS
  • [x] "Find on page" with scroll & highlight
  • [x] Categorized view (images, documents, videos, audio)
  • [ ] Beaver Builder / Divi / WPBakery support
  • [ ] Scan Gutenberg block attributes (reusable blocks)
  • [ ] Scheduled automatic scans

License

GPL-2.0+