Replace media files while maintaining their original URLs and metadata. Update PDFs, images, or documents without breaking existing links.
| Author: | Troy Chaplin (profile at wordpress.org) |
| WordPress version required: | 6.6 |
| WordPress version tested: | 6.9 |
| Plugin version: | 1.0.0 |
| Added to WordPress repository: | 17-11-2025 |
| Last updated: | 17-11-2025 |
| Rating, %: | 0 |
| Rated by: | 0 |
| Plugin URI: | |
| Total downloads: | 170 |
 Click to start download |
|
Smart Media Replacement is a WordPress plugin that allows you to replace media files while maintaining their original URLs and metadata. This is particularly useful for updating files like PDFs, images, or other documents without breaking existing links, especially when organizing media in year and month based folders.
Features
- Replace media files while maintaining original URLs
- Preserves all existing links (both internal and external)
- Maintains file metadata and relationships
- Simple and intuitive interface in the WordPress Media Library
- Supports all file types supported by WordPress
- Validates file names to prevent accidental URL changes
- Enforces dimension matching for images to prevent layout issues
- Automatically handles WordPress scaled images
- Validates file type matching to ensure consistency
- AJAX-based replacement with error handling
Important Requirements
Filename Matching
The new file MUST have exactly the same filename as the original file. For example, if your original file is logo.png, your replacement must also be named logo.png.
Image Dimensions (Images Only)
For images, the replacement MUST have identical dimensions (width × height) to prevent layout issues.
File Types
The replacement file must be the same file type as the original. The plugin validates MIME types to ensure consistency.
Privacy
This plugin:
* Does not collect or transmit any user data
* Does not use cookies
* Only processes files locally on your server
* Does not communicate with external services
Usage
- Go to the WordPress Media Library
- Find the file you want to replace
- Click on the file to view its details
- Look for the “Replace File” button in the attachment details
- Click “Replace File” and select your new file
- The replacement will happen automatically
Screenshots
FAQ
ChangeLog