Title: Refaxination
Author: Butiá Labs
Published: <strong>Hezîran 14, 2026</strong>
Last modified: Hezîran 14, 2026

---

Search plugins

![](https://ps.w.org/refaxination/assets/banner-772x250.png?rev=3572073)

![](https://ps.w.org/refaxination/assets/icon-256x256.png?rev=3572073)

# Refaxination

 By [Butiá Labs](https://profiles.wordpress.org/butialabs/)

[Download](https://downloads.wordpress.org/plugin/refaxination.1.0.0.zip)

 * [Details](https://kmr.wordpress.org/plugins/refaxination/#description)
 * [Reviews](https://kmr.wordpress.org/plugins/refaxination/#reviews)
 *  [Installation](https://kmr.wordpress.org/plugins/refaxination/#installation)
 * [Development](https://kmr.wordpress.org/plugins/refaxination/#developers)

 [Support](https://wordpress.org/support/plugin/refaxination/)

## Description

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
    ```

## Installation

 1. Upload the `refaxination` folder to `/wp-content/plugins/`
 2. Activate the plugin through the **Plugins** menu in WordPress
 3. Use the **Tools  Refaxination** menu to view the dashboard
 4. Run scans via WP-CLI (see below)

**Requirements:**

 * PHP 8.1 or higher
 * WordPress 6.0 or higher
 * WP-CLI (for scan operations)

## FAQ

### Does this plugin delete files automatically?

No. Refaxination only reads and reports. File moves/quarantines are initiated manually
through the admin dashboard or CLI.

### Is it safe to run on a live site?

Yes. Scans are read-only. No changes are made to files or the database during a 
scan.

### What happens to moved files?

All file moves are logged in the `wp_refaxination_moves` table, which is preserved
even after uninstall (unless you explicitly opt out).

### Can I reverse a quarantine operation?

The audit log in the database records the original path of every moved file, so 
files can be manually restored.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Refaxination” is open source software. The following people have contributed to
this plugin.

Contributors

 *   [ Butiá Labs ](https://profiles.wordpress.org/butialabs/)

[Translate “Refaxination” into your language.](https://translate.wordpress.org/projects/wp-plugins/refaxination)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/refaxination/), check
out the [SVN repository](https://plugins.svn.wordpress.org/refaxination/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/refaxination/) by
[RSS](https://plugins.trac.wordpress.org/log/refaxination/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * 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

## Meta

 *  Version **1.0.0**
 *  Last updated **1 roj ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.5 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 8.2 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/refaxination/)
 * Tags
 * [audit](https://kmr.wordpress.org/plugins/tags/audit/)[files](https://kmr.wordpress.org/plugins/tags/files/)
   [media](https://kmr.wordpress.org/plugins/tags/media/)[uploads](https://kmr.wordpress.org/plugins/tags/uploads/)
 *  [Advanced View](https://kmr.wordpress.org/plugins/refaxination/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/refaxination/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/refaxination/reviews/)

## Contributors

 *   [ Butiá Labs ](https://profiles.wordpress.org/butialabs/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/refaxination/)