Replace an image through a deliberate content or media workflow so existing pages and external links do not unexpectedly break. Uploading a new file usually creates a new media item; it does not automatically update every place that used the old one.
IN THIS ARTICLE
01 Choose the replacement scope
Decide whether only one page should use the new image or every reference should change. Record the old file URL, attachment identity and known uses, including featured images, galleries, templates and external emails.
Keep the original file and a backup before a broad replacement. If an approved media-replacement plugin is used, read how it handles filenames, generated sizes, attachment IDs and caches before relying on it.
02 Replace one page occurrence
- Open the page and select the exact Image block.
- Use Replace to select or upload the new approved image.
- Review alternative text, caption, crop and link destination. A new image does not make the old descriptive text automatically correct.
- Save and check the public page at several widths.
How is replacing an image everywhere different from editing one page?
Use a supported replacement tool or a developer-reviewed migration when the same media identity or URL must be preserved. Test on staging first, including generated thumbnail URLs and any responsive-image output.
If you instead create a new media item, update every relevant reference deliberately. Do not delete the old item until the review is complete. Some external links may remain outside your control and need a compatible redirect or retained file.
03 Verify caching and references
Check the original image URL, the page output and any CDN versions. Reusing an identical URL can leave visitors seeing the old cached file until the relevant caches are refreshed or expire.
If some pages still show the old image, inspect whether they store a direct URL, use a separate thumbnail or refer to another attachment. Avoid a broad database text replacement without understanding structured and serialised data. A correct replacement preserves the intended references and updates the descriptive metadata, rather than merely making one editor preview look right.