About this plugin
Refaxination scans wp-content/uploads and cross-references every file against the database.
Attachments, post content, post meta, options, and third-party plugins, to identify files that are no longer referenced anywhere.
Features:
- Full filesystem scan of wp-content/uploads
- Database reference detection across:
- WordPress attachments and post content
- Post meta fields
- WordPress options
- ACF (Advanced Custom Fields)
- Yoast SEO
- The SEO Framework
- Safe quarantine/move operations with full audit log
- Admin dashboard with file and operation history
- All heavy operations run via WP-CLI to avoid timeouts
This plugin does not auto-delete anything. Every file operation is logged and reversible.
WP-CLI Commands
Scan the filesystem for files:
wp refaxination scan files
Scan the database for references:
wp refaxination scan refs
Generate a report:
wp refaxination report
Run with --batch=100 to process in batches (recommended for large sites):
wp refaxination scan files --batch=100