Orphan Scan

Orphan scan compares what’s actually in your bucket against what the plugin’s inventory expects, and reports remote keys with no matching attachment record.

Orphan scan is dry-run only. It reports; it never deletes anything from your bucket.

Steps

wp universal-storage health orphan

Or run it from the admin UI under Universal Storage → Health (Pro).

Verify it worked

The scan produces a list of remote keys it couldn’t match to any known attachment/object row. Review that list yourself before deciding whether (and how) to clean anything up — the plugin does not do this for you.

Troubleshooting

The scan reports objects you know are legitimate — this can happen for files uploaded outside the plugin’s own tracking (for example, uploaded directly to the bucket by another tool, or before the plugin adopted them — see wp universal-storage adopt). Run adopt first if you have pre-existing offloaded media the plugin doesn’t yet know about.