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
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/wisnuub/media-janitor/archive/refs/heads/main.zip
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+