Overwrite Compatibility

Desktop Media Uploader overwrite works when the file being replaced is a standard WordPress Media Library file.

If a theme, page builder, gallery, slider, WooCommerce product, or plugin continues to reference that same Media Library file, overwrite can replace the file without rebuilding the page, gallery, slider, or product.

If a plugin copies files into separate storage, creates separate media records, generates cached files, or replaces normal WordPress Media Library handling, overwrite may not update that plugin automatically.

Important: For best results, use standard WordPress Media Library image sizes when testing overwrite. Custom image sizes created by themes, page builders, gallery plugins, or slider plugins may not be rebuilt by Desktop Media Uploader. If a plugin stores a custom image size URL, cropped image, cached image, or generated copy outside the normal Media Library sizes, overwrite may update the original Media Library image but not that custom plugin-specific image.

Important: CDN, file acceleration, page cache, optimizer cache, gallery cache, plugin cache, and browser cache can affect overwrite results. After using overwrite, clear any caches used by the site. If cached copies of the old file are still being served, the front end may continue to show the previous version even after the Media Library file has been replaced.

Important: Do not use overwrite on Media Library entries that have been scaled, rotated, cropped, or edited by WordPress. Desktop Media Uploader replaces the main Media Library file and the selected media sizes it creates. WordPress-edited entries may have additional file relationships that Desktop Media Uploader cannot safely detect or replace. Avoid plugin Custom image size settings.

Tested and known to work with overwrite

The following tools are known to work with Desktop Media Uploader overwrite when using their standard WordPress Media Library-based workflow.

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; avoid any default Custom image 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
• Gutenberg Essential Blocks
• Beaver Builder Page Builder
• WordPress built-in Gallery Block

Galleries, sliders, carousels, and portfolio tools

• • Smart Slider 3 - clear slider cache after overwrite
  • 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 — Popup & Slider Builder
  • Carousel Slider Block for Gutenberg
  • Ultimate Responsive Image Slider

Known overwrite compatibility limitations

The following tools are known to have overwrite compatibility limitations with Desktop Media Uploader.

This does not necessarily mean there is a problem with those tools. It usually means they manage files using separate records, generated files, cached files, custom thumbnails, lightbox files, or internal references that are not fully updated when the standard WordPress Media Library file is replaced.

• Envira Gallery
• NextGEN Gallery
• FooGallery
• Meow Gallery
• Photo Gallery by 10Web
• Soliloquy
• Photo Gallery by Supsystic
• Image Photo Gallery Final Tiles Grid

Quick checklist

• Use the same file name and extension as the existing Media Library file.
• Use tools that reference files directly from the WordPress Media Library.
• Use standard WordPress Media Library image sizes when possible.
• Avoid custom image size settings when testing overwrite.
• Do not use overwrite on WordPress-scaled, cropped, rotated, or edited Media Library entries.
• Clear page cache, CDN cache, optimizer cache, gallery/plugin cache, and browser cache after overwrite.
• Test a small group of files before starting a large replacement job.

Summary

Desktop Media Uploader overwrite works best when WordPress remains the source of truth for the file being displayed or downloaded.

If your theme, page builder, gallery, slider, WooCommerce product, or plugin uses the standard WordPress Media Library file directly, overwrite can replace the existing file while the site continues to reference the same Media Library item.

If a plugin creates its own media records, copies files into separate storage, stores custom image size URLs, or serves cached/generated files, additional plugin-specific steps may be required after overwrite.