Replace Image


The Replace Image plugin adds a button to the Attachment Details screen which allows you to upload or select an image to replace the current image while retaining the URL and attachment ID. This allows you to easily swap in an updated version of an image without having to re-select it in theme settings pages, post/page content, or anywhere else where it might be referenced.

Important: Disable your browser’s cache and any WordPress caching plugins before use; otherwise, the plugin may appear not to work. See Tools > Replace Image for instructions.


  • The Replace Image button in the Attachment Details screen (opened by clicking on an image in the Media Library).


  1. Click “Plugins” > “Add New” in the WordPress admin menu.
  2. Search for “Replace Image”.
  3. Click “Install Now”.
  4. Click “Activate Plugin”.

Alternatively, you can manually upload the plugin to your wp-content/plugins directory.


I tried to replace an image but nothing happened.

Your browser is likely still caching the old image. Try doing a hard refresh (Ctrl + F5 on Windows, Apple + R / Command + R on Mac) while viewing the page on the frontend. Note that the backend seems to retain cached image thumbnails even after a hard refresh.


April 25, 2021
Replace Image es un plugin muy ligero y fácil de usar. Vale la pena implementarlo para evitar errores y complicaciones al tener que cambiar imágenes en nuestros sitios WordPress.
October 25, 2020
Better than the famous image replacement plugin while being lighter weight. Even processed my WP water mark, custom directories, custom original removal, ect. Accidentally set the threshold for full screen images just barely too small for cover images. Without this plugin Id either have to manually go into each post folder, resize them all, water mark them, and change the quality; or start over again for all my post image covers. Replace image gracefully replaces the original while following all WP standards. Thank you for this great plugin. 🙂
September 3, 2020
This plugin is a life-saver for me. When I need to update a pdf I've already released, I can just replace the image so the link remains the same as the original. I use it ALL the time.
July 23, 2020
I was needing a plugin to enable the replacement of some broken media, tried others but they cannot do it, only replace existent media, and then Replace Image is the one that worked and fitted for my needs.
June 10, 2020
A nice straight forward plugin that allows you to replace any image. Just remember to clear your cache in order to see the updated version!
April 8, 2020
It takes time for images to update with the image, but that may be wordpress caching the image. Works exactly as advertised.
Read all 49 reviews

Contributors & Developers

“Replace Image” is open source software. The following people have contributed to this plugin.


Translate “Replace Image” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Updated links, author, changed branding to Aspen Grove Studios
  • Updated tested up to
  • Removed donation links,
  • Added aspengrovestudios as contributor
  • Updated banner and icon


  • Plugin now deletes files associated with the old image prior to replacement


  • Fixed non-critical PHP warning


  • Fixed undefined offset error per


  • Added support for image replacement where the image file being replaced doesn’t exist
  • Removed anonymous functions


  • Added functionality to prevent image caching in the Media Library


  • Fixed a bug where the upload UI would temporarily stop working properly after replacing an image.


  • Initial release