OctoTidy
Media Attachment Verifier for finding Media Library assets that are likely unused across posts, meta, options, and builder data.
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/mrichwalsky/octotidy/archive/refs/heads/main.zipOctoTidy is a small WordPress plugin MVP for finding Media Library assets that are likely unused.
Tagline: Media Attachment Verifier.
It adds Media > OctoTidy Verifier in WP Admin. Click Run Verification to check common WordPress storage locations for attachment URLs, generated image-size URLs, and common attachment ID references.
What It Checks
- Post and page content
- Post excerpts
- Post meta, including builder JSON/serialized data
- Term meta
- Comment meta
- Options, excluding transients
- Original attachment URLs and generated image-size files
- Common ID references such as
wp-image-123, gallery IDs,attachment_id,image_id,thumbnail_id, and serialized equivalents
Bulk Cleanup
After a verification run, OctoTidy can move the current Likely unused results to the Media Library Trash. The cleanup form requires a checkbox, typing DELETE, and a browser confirmation.
MVP Limits
The report says Likely unused, not definitely unused. This first version does not crawl rendered frontend pages or parse theme/plugin source files.
Use it as a review tool before removing media.