Refaxination

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