Description

WP Media Doctor helps you identify and repair common Media Library problems that WordPress does not automatically detect. Over time, media collections can accumulate broken attachment records, orphaned files, duplicate uploads, missing alt text, and incorrect MIME types. WP Media Doctor scans your entire media library and provides one-click tools to diagnose and fix these issues safely, helping improve site health, SEO, accessibility, and storage efficiency.

Features

• Detects broken attachment records pointing to missing files
• Finds orphaned files stored in uploads without WordPress attachment records
• Identifies duplicate media files using MD5 content comparison
• Scans for images missing alt text and allows inline editing
• Detects and repairs incorrect MIME type records
• One-click repair actions with no page reload required
• Persistent scan results that remain available after page refresh
• AJAX-powered scanning and repair tools
• Animated scan progress interface
• Safe read-only scanning process
• Built-in security checks and capability validation

Requirements

• WordPress 5.0 or later
• PHP 7.2 or later
• PHP SPL extension enabled
• PHP Fileinfo extension or mime_content_type support
• Read and write access to the WordPress uploads directory
• Administrator or media management permissions

Instructions

Installation

1. Download the plugin ZIP package.
2. Navigate to Plugins → Add New → Upload Plugin.
3. Upload the ZIP file and click Install Now.
4. Activate the plugin.
5. Open Media → Media Doctor.

Running a Scan

1. Visit Media → Media Doctor.
2. Click Run Full Scan.
3. The plugin scans for all supported media issues in a single operation.
4. Results are saved automatically for future review.

Repairing Issues

Review the scan results and use the available action buttons:

• Delete Record to remove broken attachment references.
• Delete File to remove orphaned files from the server.
• Delete to remove duplicate attachments while keeping the original.
• Save to add or update missing image alt text.
• Fix MIME to correct inaccurate MIME type records.

Best Practices

• Run a full scan after site migrations or media imports.
• Review duplicate files periodically to reduce storage usage.
• Keep image alt text updated for better accessibility and SEO.
• Verify orphaned files before deletion if they may be used outside WordPress.
• Create a site backup before performing large-scale cleanup operations.