Skip to content

Media Audit 1.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 19 Aug 19:17
v1.0.0
a70320e
This commit was signed with the committer’s verified signature.
vagelisp Vagelis P.
GPG key ID: 2F81D9A255DF6978
Verified
Learn about vigilant mode.

Media Audit 1.0.0

Version 1.0.0 is the first stable release of Media Audit: a WordPress tool for finding files that may be unused, checking Media Library integrity, and cleaning up uploads through guarded, review-first workflows.

Audit WordPress uploads

  • Scan the complete uploads directory or start with a specific year, month, or subdirectory.
  • Match files against attachment originals, generated image sizes, edited copies, and recorded backup sizes.
  • Search posts, metadata, options, and configured custom tables for file references.
  • Stop a long-running scan without losing findings from completed batches.
  • Filter, sort, and review large result sets without rendering every row at once.

Clean up more safely

  • Preview file actions with dry-run mode.
  • Move files to quarantine and restore them to their original paths when needed.
  • Download a ZIP backup before removing originals.
  • Permanently delete selected findings or all current findings with progress feedback.
  • Revalidate references before actions to detect files that became referenced after the scan.
  • Tune scan and action batch sizes for slower servers.

Check Media Library integrity

  • Find attachment records whose original local file is missing.
  • Report generated image sizes that are recorded in metadata but absent from disk.
  • Remove confirmed leftover attachment records through WordPress's native deletion APIs.

Use it from WP-CLI

  • Run audits and guarded file actions from the command line.
  • Produce table, CSV, JSON, or YAML output for review and automation.
  • Add size, age, scope, ignore-pattern, and custom-table filters.
  • Use summary and exit-code options in scheduled jobs or CI workflows.

Safety first

Media Audit reports candidates, not guarantees. Encoded data, custom storage, external services, dynamically constructed URLs, and hardcoded references may not be detectable. Review findings, keep reliable backups, and prefer quarantine before permanent deletion.

Download media-audit-1.0.0.zip below or browse the source for this release.

Assets 4
Loading