Audits and manages orphaned files in the WordPress Uploads folder.
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.
All operations run via WP-CLI to avoid HTTP timeouts on large sites. The admin dashboard provides a read-only view of scan results and operation history.
- PHP 8.1+
- WordPress 6.0+ or ClassicPress
- WP-CLI (for scan and report commands)
# Scan the filesystem
wp refaxination scan files
wp refaxination scan files --batch=100
# Scan the database for references
wp refaxination scan refs
wp refaxination scan refs --batch=100
# Generate a report
wp refaxination report
wp refaxination report --format=json
wp refaxination report --format=csv| Table | Purpose |
|---|---|
wp_refaxination_files |
Indexed file entries with status and MIME type |
wp_refaxination_references |
Cross-reference tracking (file ↔ source) |
wp_refaxination_operations |
Operation history and progress |
wp_refaxination_moves |
Audit log of all file moves (preserved on uninstall) |
- WordPress Attachments
- Post Content
- Post Meta
- WordPress Options
- ACF (Advanced Custom Fields)
- Yoast SEO
- The SEO Framework
- SSP (Seriously Simple Podcasting)
- Add Brazilian Portuguese (pt_BR) translation
- Load plugin textdomain so bundled translations are applied
- Initial release
- Filesystem and database scanning
- Admin dashboard with tabs for Dashboard, Files, and Operations
- WP-CLI integration for scan and report commands
- Support for ACF, Yoast SEO, and The SEO Framework
- Quarantine manager with full audit log