Unused Media Checker

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)

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
• 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)

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
• Ü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/

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.

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