Asset Guardian

Know what’s safe to review before you clean your Craft CMS asset library.

Digital asset libraries grow rapidly over time with unused campaign graphics, oversized raw uploads, duplicate clones, and images missing accessibility alt text. Deleting files manually is risky—one wrong deletion can break production templates or entries.

Asset Guardian gives digital agencies, enterprise site administrators, and content teams complete visibility into asset library health with non-destructive, auditable cleanup workflows.

🛡️ Safety-First Architecture

• Never 100% Guesswork: Asset Guardian inspects real relationships across Entries, Matrix blocks (including nested blocks), CKEditor, Redactor, Categories, Users, and Globals.
• Three Deterministic Risk Tiers: Assets are classified into Low, Medium, and High risk based on references and a configurable upload grace period.
• Soft Delete by Default: All cleanup operations move files to the native Craft CMS Trash. Nothing is permanently destroyed immediately, and files can be restored with 1-click.
• High-Risk Safeguards: Actively referenced files are locked and excluded from bulk deletion selections.
• Dry-Run Simulations: Test every cleanup operation before committing to see affected files and reclaimable storage.

✨ Core Features

• Unified Health Dashboard: Deterministic 100-point hygiene rating factoring in unreferenced files, duplicate clones, oversized media, and missing alt text.
• Storage Footprint Analysis: Visual storage breakdowns grouped by volume and file kind (Images, Documents, Videos, Vectors, Archives).
• Content-Hash Duplicate Detection: Fast MD5 fingerprinting identifies identical files regardless of filename.
• Safe Duplicate Repointing: Transactionally re-links all entries, matrix blocks, and relations to the primary asset before moving duplicate clones to trash.
• Large Files Triage: Instantly filter files exceeding configurable thresholds (1 MB, 5 MB, 10 MB, 50 MB, 100 MB).
• Missing Alt Text Center: Real-time accessibility compliance tracking with an inline AJAX quick-save editor.
• Multi-Attribute Asset Explorer: Deep inventory search with server-side pagination.
• Audit History & 1-Click Restore: Complete logs tracking user attribution, affected assets, reclaimed bytes, and 1-click restoration.
• Exportable CSV Reports: Download 4 comprehensive datasets for client handoffs and compliance audits.
• Terminal CLI Automation: Full console commands (health, scan, cleanup --dry-run) ready for cron jobs and deployment pipelines.
• 100% On-Premises Privacy: Operates entirely on your server with zero external telemetry or cloud data transfers.

📋 Requirements

• Craft CMS 5.0.0 or higher
• PHP 8.2.0 or higher
• MySQL 8.0+ or PostgreSQL 13+