Flying Pigs Help deskOverwrite Compatibility
Overwrite is a Pro feature. Turn on Overwrite existing files in the run options, re-upload a file with the same name, and it replaces the existing media library entry at the same URLs and the same attachment ID. Nothing that uses the image has to be rebuilt.
After the files are replaced, Flying Pigs repairs references to the old size files: post content, post meta and options, Kadence and Spectra galleries, stale srcset lists, and the Elementor, Divi and Smart Slider 3 caches.
With WebP only on, a re-uploaded photo.jpg can replace an earlier photo.jpg (it becomes photo.webp) or an earlier WebP-only photo.webp. Pick which under Overwrite match.
Important: use standard WordPress image sizes. A theme or plugin that keeps its own custom-size copies, cropped copies or cached copies outside the media library may keep showing the old image.
Important: clear your caches after an overwrite: page cache, CDN, optimizer cache, gallery or slider cache. The addresses do not change, so a cached copy of the old file can keep being served. Visitors who saw the old image may see it until their browser cache lets go.
Important: do not overwrite entries that were cropped, rotated or edited in WordPress. Those have extra files Flying Pigs cannot safely match.
Tested and known to work with overwrite
Each of these is covered by Flying Pigs' automated overwrite test: a page is built with the tool, the image is overwritten twice, and every image address on the rendered page is checked to load the new file.
Elementor and Elementor add-ons
- Elementor Website Builder
- Essential Addons for Elementor
- Royal Addons for Elementor
- Ultimate Addons for Elementor
- ElementsKit Elementor Addons
- Premium Addons for Elementor
- Element Pack
- Qi Addons For Elementor
- Jeg Kit for Elementor
- Happy Addons for Elementor (use normal image sizes, not a custom resolution)
- Unlimited Elements For Elementor
- Prime Slider Addons for Elementor
- PowerFolio
- Addon Elements for Elementor
Themes, page builders, blocks and WooCommerce
- Divi Builder
- WPBakery Page Builder
- Page Builder by SiteOrigin
- Astra Theme
- Avada Theme
- WooCommerce
- Kadence Blocks
- Spectra
- Essential Blocks
- Beaver Builder
- WordPress's built-in Gallery block
Galleries, sliders, carousels and portfolios
- Smart Slider 3
- Modula Image Gallery
- Robo Gallery
- MetaSlider / Meta Gallery
- Simple Gallery Blocks
- Portfolio Filter Gallery
- Responsive Lightbox & Gallery
- GT3 Image Gallery
- Visual Portfolio
- Gallery by BestWebSoft
- WP Carousel
- SimpLy Gallery
- Ultimate Before After Image Slider & Gallery
- Depicter
- Carousel Slider Block for Gutenberg
- Ultimate Responsive Image Slider
Known limitations
These tools keep their own records, thumbnails, lightbox copies or caches, so replacing the media library file does not update everything they show:
- Envira Gallery
- NextGEN Gallery
- FooGallery
- Meow Gallery
- Photo Gallery by 10Web
- Soliloquy
- Photo Gallery by Supsystic
- Image Photo Gallery Final Tiles Grid
That is not a fault in those tools. After an overwrite they may need their own rebuild or cache clear.
Quick checklist
- Use the same file name as the existing media library file.
- Use tools that show images straight from the media library, with standard sizes.
- Do not overwrite entries cropped, rotated or edited in WordPress.
- Leave the media folder on "none" unless you mean to move the files.
- Clear page, CDN, optimizer and gallery caches afterwards.
- Try a few files before a big replacement run.