HK Media Optimizer

HK Media Optimizer

HK Media Optimizer scans your Media Library and tells you exactly which files are no longer used anywhere on your site, so you can safely reclaim disk space. It runs entirely locally — no data is ever sent to an external server. Why it is different Unlike heavier media-cleaning tools, every scan runs in small, […]

Installation & First Scan

Get up and running with your first scan in a few clicks. Install Upload the plugin to /wp-content/plugins/hk-media-optimizer, or install it directly through Plugins → Add New by searching “HK Media Optimizer”. Activate and scan Activate the plugin, then go to Media Optimizer in your admin menu and click “Start Scan” to run your first […]

Understanding Scan Sources

The scanner checks for media usage across every place WordPress commonly references a file. What gets checked Post and page content, Featured Images, direct attachment relationships (files uploaded into a post), custom fields / post meta, Advanced Custom Fields (ACF) values when ACF is active, widgets (including block-based widgets), Theme Customizer settings (logo, background, header […]

Safety Settings

Several layers of protection exist before any file can be permanently removed. Safety window Recently uploaded files are protected for a configurable window of time, so brand-new uploads are never flagged as unused before they’ve even been placed anywhere. Whitelisting You can whitelist specific files or entire folders to permanently exclude them from scan results. […]

Finding Duplicate Files

The Duplicate Finder identifies true duplicate files in your Media Library, even if they were re-uploaded under a different name. How duplicates are detected Every file is compared by its actual contents using an MD5 hash — not filename or upload date — so only byte-for-byte identical files are grouped together. Reclaiming space safely Duplicate […]

Exporting Results & Scheduled Scans

Keep records of your scans and automate future ones. CSV export Export your unused, in-use, or full scan results to a CSV file at any time from the results screen. Scheduled scans Turn on daily, weekly, or monthly scheduled scans from Settings to get an automatic email summary report. Scheduled scans never delete anything — […]

Frequently Asked Questions

Answers to the most common questions about HK Media Optimizer. Does this plugin delete files automatically? No. It never deletes anything on its own. It only flags files as unused — you choose what to delete, and must explicitly confirm before any permanent removal happens. Can I undo a deletion? No, deletion is permanent once […]