HoatzinMedia is a WordPress media cleaner and storage optimizer that helps you reclaim disk space and improve site performance by identifying unused attachments, oversized uploads, and storage pressure signals. It includes a clear dashboard, a reversible trash workflow, and batch-based scanning desi
PricingFree downloadThe WordPress.org download is free. Pro versions, add-ons or external services may cost extra.
CompatibilityRequires WordPress 5.8 and PHP 7.4.
SourceWordPress plugins · Oct 20, 2026
01 / Source details
About this tool.
HoatzinMedia is a WordPress media cleaner and storage optimizer that helps you reclaim disk space and improve site performance by identifying unused attachments, oversized uploads, and storage pressure signals. It includes a clear dashboard, a reversible trash workflow, and batch-based scanning designed for large media libraries.
Benefits:
01Reduce storage usage by finding unused and heavy media files
02Improve WordPress performance by keeping uploads lean and organized
03Delete with confidence using a safe trash table with restore support
04Scale to large sites with batch processing and scan locking
Modules
05Dashboard What it does: Shows media health score, server/storage signals, and library breakdowns.
06REST endpoints: GET /wp-json/hoatzinmedia/v1/dashboard, GET /wp-json/hoatzinmedia/v1/dashboard/uploads-breakdown
07Hook points: Refreshes automatically after content changes via save_post cache bump; scan completion clears the dashboard transient.
08Smart Scan & Unused Media What it does: Batch-based scanning to detect unused attachments, then review and delete safely.
09REST endpoints: POST /wp-json/hoatzinmedia/v1/scan, GET /wp-json/hoatzinmedia/v1/unused-results, POST /wp-json/hoatzinmedia/v1/delete-unused, POST /wp-json/hoatzinmedia/v1/delete-unused-all
10Hook points: WP-Cron action hoatzinmedia_scheduled_scan runs a full scan when scheduling is enabled; the scanner uses posts_where during content search to reduce query overhead.
11Large Files Explorer What it does: Lists media files over a size threshold so you can quickly reclaim space.
12REST endpoints: GET /wp-json/hoatzinmedia/v1/large-files?size=1|3|5 (MB threshold)
13Duplicate Checker What it does: Finds likely duplicate attachments and helps you validate before removal.
14REST endpoints: GET /wp-json/hoatzinmedia/v1/duplicates, GET /wp-json/hoatzinmedia/v1/attachment-usage?attachment_id=123
15Hook points: Adds Media Library UI enhancements via manage_upload_columns, manage_media_columns, and manage_media_custom_column.
19Hook points: add_attachment can auto-convert new JPEG/PNG uploads based on settings; delete_attachment cleans up converted variants; background jobs run on the hoatzinmedia_convert_job_run action.
20Regenerate Thumbnails What it does: Rebuilds WordPress image sizes for selected attachments (useful after theme changes).
21REST endpoints: GET /wp-json/hoatzinmedia/v1/regenerate/library, GET /wp-json/hoatzinmedia/v1/regenerate/sizes, POST /wp-json/hoatzinmedia/v1/regenerate, plus background endpoints under /regenerate/background/*
22Hook points: Background jobs run on the hoatzinmedia_regenerate_job_run action.
23Modules & Settings What it does: Enables/disables features and stores global plugin settings.
24REST endpoints: GET/POST /wp-json/hoatzinmedia/v1/modules, GET/POST /wp-json/hoatzinmedia/v1/settings, GET /wp-json/hoatzinmedia/v1/status
25Hook points: admin_menu registers the HoatzinMedia admin pages; init ensures scan scheduling and updates WebP serving rules when enabled.
26SVG Upload Support (optional) What it does: Allows SVG uploads with sanitization safeguards (including Elementor compatibility).
28Dashboard with media health score and live metrics
29Unused media scanner with batch processing and locking
30Safe trash table for reversible deletions
31Large file explorer by size threshold
32Translation-ready UI and REST responses
Usage
33Review the media health score and high-level stats on the dashboard.
34Run an unused media scan from the Unused media scanner panel.
35Inspect results and move files to the HoatzinMedia trash.
36Use the large file explorer to identify heavy attachments by size.
See it in action
Screenshots & previews.
Unused media scanner with progress and badgesModule enable/disable panelConvert images to webp/avif panelRegenerate thumbnails panelDuplicates checker panel
02 / Source details
Getting started.
01Upload the hoatzinmedia-library-cleaner folder to the /wp-content/plugins/ directory.
02Activate HoatzinMedia through the Plugins menu in WordPress.
03Open the HoatzinMedia page under the main admin menu.
03 / Source details
Frequently asked questions.
Does HoatzinMedia delete files immediately?
No. By default, deletions use a custom HoatzinMedia trash table so items can be restored before permanent removal.
Is it safe on large libraries?
Yes. Scans run in batches with locking to avoid concurrent runs and to keep requests small.
Website LLMs.txt and LLMs-Full.txt Generator is an LLMs.txt generator and llms-full.txt generator for WordPress. It helps site owners generate, manage, preview, validate, and serve AI discovery files from published public content. Use it to create structured /llms.txt and optional /llms-full.txt end
EngageDock AI is a customizable floating contact widget for WordPress websites that want more leads and faster visitor communication. It helps small businesses turn website traffic into calls, texts, emails, and callback requests from one clean contact panel. Key Features: Click-to-Call – One tap ca
Altify AI is an auto ALT text and AI ALT text plugin for WordPress images. It helps generate descriptive image ALT text for accessibility and image SEO. Use bulk image ALT text tools for your Media Library, generate featured image ALT text automatically, and scale WooCommerce image ALT updates with
The Accepted Payment Methods plugin is a straightforward, lightweight solution that enhances your website by displaying visually appealing icons of the payment methods you accept. This plugin is ideal for a variety of websites, including e-commerce platforms, service-oriented websites, and informati
