Title: Unused Media Checker Author: Der Webfuchs Published: July 8, 2024 Last modified: July 22, 2026 --- Search plugins ![](https://ps.w.org/unused-media-checker/assets/icon-128x128.PNG?rev=3114488) # Unused Media Checker By [Der Webfuchs](https://profiles.wordpress.org/derwebfuchsde/) [Download](https://downloads.wordpress.org/plugin/unused-media-checker.1.3.7.zip) * [Details](https://wordpress.org/plugins/unused-media-checker/#description) * [Reviews](https://wordpress.org/plugins/unused-media-checker/#reviews) * [Installation](https://wordpress.org/plugins/unused-media-checker/#installation) * [Development](https://wordpress.org/plugins/unused-media-checker/#developers) [Support](https://wordpress.org/support/plugin/unused-media-checker/) ## Description #### English Unused Media Checker helps you identify, inspect, and safely remove unused media files from your WordPress Media Library. The plugin analyzes your site and lists attachments that are _not_ referenced in: * Posts, pages, and all public custom post types (including featured images/thumbnails) * Post content (Gutenberg blocks and classic content with `wp-image-ID` classes) * Direct image URLs from the uploads folder (`wp-content/uploads/...`) * Advanced Ads (media referenced via the `advanced_ads_media` meta) * Theme Customizer (site logo, site icon, header image, background image – including retina variants) * Rank Math FAQ blocks (images stored in FAQ block attributes) * Photo Gallery (10Web): optional filename-based warning in the unused list (usage is not mapped via attachment IDs) Key features: * Clear list of potentially unused attachments with thumbnails, title, date and quick “Inspect” link * Accurate detection that respects logos, favicons, featured images and common SEO/ads integrations * Bulk delete with nonce protection and clear success messages – no unexpected white screens * Safe individual delete buttons per item with confirmation dialog * Pagination and list rendering powered by WordPress’s native `WP_List_Table` class * Optional Photo Gallery (10Web) helpers: - Media Library warning when a file with the same name exists in Photo Gallery - Photo Gallery files report (uploads/photo-gallery/) with grouping and an “ unused motif” filter * Fully translation-ready via the textdomain `unused-media-checker` #### Deutsch Unused Media Checker hilft Ihnen, ungenutzte Dateien in Ihrer WordPress‑Mediathek zu identifizieren, zu überprüfen und sicher zu entfernen. Das Plugin analysiert Ihre Website und listet Anhänge, die _nicht_ referenziert werden in: * Beiträgen, Seiten und allen öffentlichen Custom Post Types (inkl. Beitragsbilder/ Thumbnails) * Beitragsinhalten (Gutenberg‑Blöcke und klassischer Editor mit `wp-image-ID`‑Klassen) * Direkt eingebundenen Bild‑URLs aus dem Uploads‑Ordner (`wp-content/uploads/...`) * Advanced Ads (Medien im Meta‑Feld `advanced_ads_media`) * Theme‑Customizer (Website‑Logo, Website‑Icon, Header‑Bild, Hintergrundbild – inkl. Retina‑Varianten) * Rank‑Math‑FAQ‑Blöcken (Bilder in den FAQ‑Block‑Attributen) * Photo Gallery (10Web): optionaler Dateinamen‑Hinweis in der Unused‑Liste (Nutzung wird nicht über Attachment‑IDs gemappt) Funktionen: * Übersichtliche Liste potenziell ungenutzter Anhänge mit Vorschaubild, Titel, Datum und “Inspect”‑Link * Präzise Erkennung, die Logos, Favicons, Beitragsbilder und gängige SEO/Ads‑Integrationen berücksichtigt * Massenlöschung mit Nonce‑Schutz und klaren Erfolgsmeldungen – keine unerwarteten weißen Seiten * Sicheres, einzelnes Löschen je Datei mit Bestätigungsdialog * Massenaktionen und Paginierung basierend auf der WordPress‑Klasse `WP_List_Table` * Optionale Photo Gallery (10Web) Hilfen: - Warnhinweis in der Mediathek‑Unused‑Liste, wenn ein gleichnamiges File in Photo Gallery existiert - Report für Photo Gallery Dateien (uploads/photo-gallery/) inkl. Gruppierung und Filter „Nur ungenutzte Motive“ * Übersetzungsbereit über die Textdomain `unused-media-checker` (z. B. Deutsch, Englisch und weitere Sprachen) ### Support For issues or questions, visit: https://derwebfuchs.de/wordpress-mediathek-aufraumen- unused-media-checker/ ## Installation Download the plugin ZIP file. In the WordPress admin, go to Plugins > Add New > Upload Plugin and select the ZIP. Activate the plugin through the Plugins menu. Navigate to Media > Unused Media Checker to start cleaning up. ## FAQ ### Will deleting unused media files affect my site? No. Only files identified as unused are listed. Use the “Inspect” button to verify before removal. ### Why aren’t my AdvancedAds images listed? Media used in AdvancedAds is automatically detected and excluded from the list. ### Do I need any settings? No. Install and activate the plugin – it works out of the box. ## Reviews ![](https://secure.gravatar.com/avatar/e8f1a812c4d230ec87c5c5f4952c555322a64a01c1f0b34a749a02285edd8f8d? s=60&d=retro&r=g) ### 󠀁[App with many features](https://wordpress.org/support/topic/app-with-many-features/)󠁿 [Amanda](https://profiles.wordpress.org/amandalang/) February 9, 2026 This is a differentiated app with many features. Questions about how to use it are answered quickly.Highly recommended! [ Read all 1 review ](https://wordpress.org/support/plugin/unused-media-checker/reviews/) ## Contributors & Developers “Unused Media Checker” is open source software. The following people have contributed to this plugin. Contributors * [ Der Webfuchs ](https://profiles.wordpress.org/derwebfuchsde/) [Translate “Unused Media Checker” into your language.](https://translate.wordpress.org/projects/wp-plugins/unused-media-checker) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/unused-media-checker/), check out the [SVN repository](https://plugins.svn.wordpress.org/unused-media-checker/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/unused-media-checker/) by [RSS](https://plugins.trac.wordpress.org/log/unused-media-checker/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.3.7 * New scan modes: - Quick scan (faster, may miss usage) — trash only - Thorough scan (recommended) — can delete permanently * New deep scan options (Thorough scan only): Widgets and Uploaded-to * Performance: conservative caching for aggregated “used attachment IDs” and cache invalidation on relevant content changes * Performance: reduced DB query load in Media Library list rendering * Performance: improved cache-miss scan performance for large sites * Inspect: cached detected usage sources for faster repeated inspections * Developer: optional profiling output via ?umc_profile=1 to diagnose slow scans( time, queries, cache hit/miss) * Fix: improved PHP 8+ compatibility for cache invalidation hooks #### 1.3.6 * Photo Gallery (10Web): show a warning in the Media Library unused list when a file with the same name exists in Photo Gallery * Photo Gallery (10Web) files report: improved motif grouping so imported Media Library variants (imported_from_media_libray/.original + thumb) are grouped consistently #### 1.3.5 * Improved pagination UX after deletions: - stay on the current page when deleting a single item - automatically fall back to the last valid page if a page becomes empty - only show the “No unused media found” message when all unused items are really gone #### 1.3.4 * Tested with WordPress 6.9 and updated compatibility headers * Fixed nonce handling for bulk actions to avoid “Security check failed” errors from unrelated POST requests * Prevented blank pages after deletion and improved success notices directly on the Unused Media Checker screen * Greatly improved detection of _used_ media: - scans all public post types (not only posts/pages) - detects direct image URLs from the uploads folder - includes Theme Customizer media (logo, site icon, header/background images, retina variants) - recognizes images used in Rank Math FAQ blocks #### 1.3.3 Removed unused CSS/JS – now relies on native List Table styles Updated version and README #### 1.3.2 Removed script.js and style.css enqueue #### 1.3.1 Added Inspect button before delete #### 1.3.0 Database queries with LIMIT/OFFSET WP_List_Table integration AdvancedAds support Centralized capability and nonce checks ## Meta * Version **1.3.7** * Last updated **6 days ago** * Active installations **200+** * WordPress version ** 6.0 or higher ** * Tested up to **7.0.2** * PHP version ** 8.0 or higher ** * Tags * [cleanup](https://wordpress.org/plugins/tags/cleanup/)[gallery](https://wordpress.org/plugins/tags/gallery/) [media](https://wordpress.org/plugins/tags/media/)[optimization](https://wordpress.org/plugins/tags/optimization/) [unused](https://wordpress.org/plugins/tags/unused/) * [Advanced View](https://wordpress.org/plugins/unused-media-checker/advanced/) ## Ratings 5 out of 5 stars. * [ 1 5-star review ](https://wordpress.org/support/plugin/unused-media-checker/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/unused-media-checker/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/unused-media-checker/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/unused-media-checker/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/unused-media-checker/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/unused-media-checker/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/unused-media-checker/reviews/) ## Contributors * [ Der Webfuchs ](https://profiles.wordpress.org/derwebfuchsde/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/unused-media-checker/)