About this plugin
Need to swap a product photo, a team headshot or an outdated banner? Instead of hunting down every page, post, widget and page-builder section that uses it, open the image in the Media Library, click Replace Image, choose the new one, and confirm. Every place that used the old image now shows the new one.
How it works
The original library item is kept: same ID, title, alt text, caption and permalink. Only its file is swapped and all thumbnail sizes are regenerated. Anything that stores the image by ID keeps working with no changes at all, and any file URL that did change is updated automatically across the site.
Features
- A “Replace Image” button in the Attachment details sidebar (grid view), the Edit Media screen and the list-view row actions.
- Pick an existing library image or upload a new one, using the familiar media window.
- A confirmation prompt showing the current and new images side by side, where the image is used, and a required “I understand” checkbox.
- Keep the current filename (links stay identical) or use the new file’s name.
- Changing file type (for example JPG to PNG or WebP) is supported; links are updated for you.
- Serialization-safe URL updates in post content, excerpts, custom fields, term meta and settings, including Elementor’s JSON data.
- Automatic rollback: if anything fails, the original files and data are restored.
- Optional clean-up of the replacement’s own library entry when it isn’t used anywhere.
- Loads nothing on the front end, and in wp-admin only on screens that already load the media window.
Privacy
This plugin does not collect data, set cookies, or contact any external service.
Usage
- Go to Media → Library and click an image.
- In the Attachment details sidebar, click Replace Image. (In list view, hover the image row and click Replace Image.)
- Choose the new image from the library, or open the Upload files tab to upload one, then click Use this image.
- Review the confirmation prompt: both images, where the current one is used, and the filename options.
- Tick I understand… and click Replace Image.
- If you use a page cache or CDN, clear it so visitors see the new image straight away.
By default, Editors and Administrators can replace images (it needs the upload_files and edit_others_posts capabilities), because a replacement changes content across the whole site.