Plugins DatabasePlugins Database logo
Back to plugins
WordPress

Actions

DownloadAuthor pageSee on WordPress

Plugin info

Total downloads: 48
Active installs: 0
Total reviews: 0
Average rating: 0
Support threads opened: 0
Support threads resolved: 0 (0%)
Available in: 1 language(s)
Contributors: 1
Last updated: 11/17/2025 (44 days ago)
Added to WordPress: 11/17/2025 (0 years old)
Minimum WordPress version: 6.6
Tested up to WordPress version: 6.9
Minimum PHP version: 7.0

Maintenance & Compatibility

Maintenance score

Actively maintained • Last updated 44 days ago

59/100

Is Smart Media Replacement abandoned?

Likely maintained (last update 44 days ago).

Compatibility

Requires WordPress: 6.6
Tested up to: 6.9
Requires PHP: 7.0

Ratings

0
0
0
0
0See all reviews

Developers

Troy Chaplin (Owner)3

Languages

Similar & Alternatives

Explore plugins with similar tags, and compare key metrics like downloads, ratings, updates, support, and WP/PHP compatibility.

Enable Media Replace
Rating 4.4/5 (300 reviews) • Active installs 600,000
Compare
iFolders – Ultimate Folder Organizer for Media Library, Pages, Posts and Users
Rating 4.6/5 (10 reviews) • Active installs 300
Compare
MediaCommander – Bring Folders to Media, Posts, and Pages
Rating 0.0/5 (0 reviews) • Active installs 20
Compare
Search & Replace
Rating 4.3/5 (282 reviews) • Active installs 100,000
Compare
Search Regex
Rating 4.7/5 (97 reviews) • Active installs 100,000
Compare
Remove Footer Credit
Rating 4.7/5 (87 reviews) • Active installs 80,000
Compare
See more alternatives to Smart Media Replacement

Description

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

Installation

  1. Download the plugin files
  2. Upload the replace-media folder to the /wp-content/plugins/ directory, or install the plugin through the WordPress plugins screen directly
  3. Activate the plugin through the ‘Plugins’ screen in WordPress

Frequently Asked Questions

Why do I get an error about file names not matching?

The replacement file must have exactly the same filename as the original file. Rename your replacement file to match the original filename exactly, including the file extension.

Why must image dimensions match?

Enforcing identical dimensions prevents layout issues where images might break your design. If you need to change dimensions, consider uploading as a new image instead.

What if my image was scaled by WordPress?

If WordPress automatically scaled your original image (large uploads), upload your replacement with the original filename (without -scaled). The plugin will handle the scaling automatically and show you the correct filename if there’s a mismatch.

Can I replace a JPG with a PNG?

No, the replacement file must be the same file type as the original to maintain consistency and prevent unexpected behavior.

The button is not appearing, what should I do?

Make sure you’re viewing the attachment details (click on a media item), clear your browser cache, and check that you have permission to edit media files.

Do I need special permissions?

Yes, you must have the edit_post capability for the specific attachment. Contact your site administrator if you believe you should have access.

Can I disable dimension enforcement for specific images?

Yes, developers can use the smart_media_replacement_enforce_dimensions filter to disable or customize dimension enforcement for specific attachments. See the Developer Hooks section for details.

Review feed

No reviews available

Screenshots

  1. Replace File button in the Media Library attachment details

    Replace File button in the Media Library attachment details

  2. Repalce file from the list of media library items

    Repalce file from the list of media library items

Changelog

1.0.0

  • Initial release
  • Replace media files while maintaining URLs
  • Filename validation to prevent URL changes
  • Image dimension enforcement to prevent layout issues
  • WordPress scaled image handling
  • File type validation for consistency
  • AJAX-based replacement with error handling
  • Developer hooks for customization
Back to plugins