How to replace an image everywhere

Learn how to swap out an image across your entire WordPress site at once, without hunting down every page it appears on.

Replacing an old logo, a staff headshot, or an outdated product photo used to mean hunting through every page on your site. There's a smarter way: with a free plugin, you can swap the image file in the media library, and the change shows up everywhere that file is used.

Quick summary

The cleanest way to replace an image everywhere is to open it in the media library and use the Replace media option. WordPress doesn't include this on its own; it comes from a plugin. Alternatively, you can delete the old image and upload a new one — but you'll need to re-insert it on every page manually. For a logo or image used in many places, always use the replace-in-place method.

Two approaches to replacing an image

Replace in place

The image file is swapped out while its URL stays the same. Every page that uses the image automatically shows the new version. No re-linking needed.

Best for: Logos, headshots, product images used in multiple places.

Delete and re-upload

You delete the old image and upload a new one with a new URL. You then have to go to every page that used the old image and insert the new one manually.

Best for: Images used in only one place, where you want a fresh URL.

Method 1: Replace in place (recommended)

WordPress doesn't include a "replace image" feature by default, but it is easy to add with a free plugin. The plugin Enable Media Replace is a well-established option that adds a Replace media option directly in the media library.

Check with us before installing plugins

If we manage your site, please ask us to install the plugin rather than doing it yourself — this avoids any compatibility issues. Send us a message and we'll get it set up quickly.

Once the plugin is installed:

Go to Media → Library in your dashboard and find the image you want to replace.

Click the image to open its detail panel.

Find Replace media and click Upload a new file. The plugin adds this to the detail panel, so scroll down if you don't see it. (In list view, hover over the file and click Replace media instead.)

Choose your replacement file. On the Replace Media Upload screen, select a file from your computer or drag it onto the page. The plugin gives you two options: Just replace the file (keeps the same file name and URL), or Replace the file, use the new file name, and update all links.

For the "everywhere" effect, choose Just replace the file. It keeps the same URL, so every page that shows the image picks up the new version. The new file must be the same type as the old one (for example, a JPG to replace a JPG). The other option also updates the links on your site, but any other website that links straight to the old file will get a broken link.

Click Upload. The plugin replaces the file and creates fresh size copies of the image. The replacement is permanent, so double-check you picked the right file.

Check your site. Visit a few pages that used the image and confirm the new version is showing. You may need to hard-refresh your browser to clear its cache: in Chrome or Edge, press Ctrl+Shift+R on Windows or Command+Shift+R on Mac. Other browsers may use a different shortcut.

Method 2: Delete and re-upload manually

Use this approach only if the image appears in just one or two places.

Make a note of where the image is used. Click the image in the media library and check Uploaded to in the detail panel. It shows a post or page the image is attached to, if there is one. It doesn't list every page that uses the image, so if it may be used in several places, stick with Method 1.

Upload your new image. Go to Media → Add Media File and upload the replacement file. Give it a descriptive name before uploading.

Open each page or post where the old image appeared. Navigate to the page in the editor.

Click the image block. In the block toolbar that appears, click Replace, then choose the new image from your media library.

Add alt text to the new image. See image sizes, cropping & alt text.

Click Save (Update on older versions of WordPress) to publish the change on each page.

Delete the old image from the media library if it's no longer needed. Deleting from the media library is permanent, so make sure nothing else uses it.

Replacing your site logo

Your logo is a special case — it's typically set in your theme settings rather than embedded in a page. Replacing it is done differently:

If your site uses a classic theme: Go to Appearance → Customize → Site Identity and upload your new logo there (if your theme supports a logo).
If your site uses a block theme (the Site Editor): Go to Appearance → Editor, open Identity, and change the site logo there. You can also change the Site Logo block in your header. See using the WordPress site editor for more detail.
If you use a page builder like Elementor: Open your header template in the builder and swap the image there. If the header uses Elementor's Site Logo widget, change the logo in Elementor's Site Settings → Site Identity instead.

See changing your logo, site title & favicon for full step-by-step instructions on logo changes.

Browser cache can make it look like nothing changed

After replacing an image, you might still see the old version in your browser. This is because your browser saved (cached) the old image. In Chrome or Edge, press Ctrl+Shift+R (Windows) or Command+Shift+R (Mac) to force a fresh load; other browsers may use a different shortcut. Visitors see the new image once their browser, and any caching on your site or CDN, picks up the new file.

Common questions

I replaced the image but some pages still show the old one. Why?

Most likely your browser or a caching plugin is serving the old version. Try a hard refresh (see above). If the problem persists, your hosting or a CDN may be caching the old file, and we can clear that for you. If the file itself still hasn't changed, the plugin may not have been allowed to overwrite it (a server permissions issue). Ask us to check.

The 'Replace media' button isn't showing. What's wrong?

The Enable Media Replace plugin may not be installed or activated. Ask us to install it, or check under Plugins → Installed Plugins in your dashboard to make sure it's active.

Do I need to update alt text after replacing an image?

Yes, if the new image shows something different. The alt text doesn't update automatically. Go to the media library, click the image, and update the Alternative Text field. Each Image block also keeps its own copy of the alt text, so update the block's Alternative text setting on pages where the image appears. See image sizes, cropping & alt text.

What if the same image appears in the header, footer, and several pages?

That's exactly the scenario where replacing in place (Method 1) saves the most time. One swap in the media library updates every instance across the whole site.

Need a hand?

If you're stuck, email support@chykalophia.com and we'll help. Include your website address and a screenshot if you can.