plugin-icon

Smart Media Replacement

Replace media files while maintaining their original URLs and metadata. Update PDFs, images, or documents without breaking existing links.
Version
1.0.0
Last updated
Nov 17, 2025
Smart Media Replacement

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

  1. Go to the WordPress Media Library
  2. Find the file you want to replace
  3. Click on the file to view its details
  4. Look for the “Replace File” button in the attachment details
  5. Click “Replace File” and select your new file
  6. The replacement will happen automatically
Freeon Business plan
Tested up to
WordPress 6.9
This plugin is available for download for your site.